Skip to main content

Quickstart

1) Install​

npm install @mappa-ai/mappa-node

2) Set API key​

export MAPPA_API_KEY="your_api_key_here"

3) Generate a report from URL​

quickstart.ts
import { Mappa } from "@mappa-ai/mappa-node";

const mappa = new Mappa({ apiKey: process.env.MAPPA_API_KEY! });

const report = await mappa.reports.generateFromUrl({
  url: "https://example.com/sales-call.mp3",
  output: { template: "sales_playbook" },
  target: { strategy: "dominant" },
});

console.info(report.id);
console.info(report.markdown ?? "no markdown payload");

4) Run​

node quickstart.ts

Async production pattern​

const receipt = await mappa.reports.createJobFromUrl({
  url: "https://example.com/sales-call.mp3",
  output: { template: "sales_playbook" },
  target: { strategy: "dominant" },
  webhook: { url: "https://your-app.com/webhooks/mappa" },
});

console.info(receipt.jobId, receipt.status);