Personade API

Your recordings, and whether each one can be personalized from right now. When usable is false, blockedReason says what a person has to do about it: the voice is still cloning, no video was uploaded, or the recording has no name in it to swap.

{
  "templates": [
    { "id": "9f1c...", "name": "Founder intro, 40s",
      "usable": true, "createdAt": "2026-08-02T09:14:22.000Z" },
    { "id": "5c02...", "name": "Q3 re-record",
      "usable": false, "blockedReason": "The voice is still being prepared. Try again shortly.",
      "createdAt": "2026-08-11T16:02:10.000Z" }
  ]
}

Capped at 50, newest last. A workspace has a handful of recordings, not thousands.

Your campaigns, newest first. Takes an optional ?limit= between 1 and 100, default 25.

{
  "campaigns": [
    { "id": "3b7e...", "name": "Series A ops leads", "status": "qa_ready",
      "leadCount": 42, "waiting": 39, "complete": 3, "failed": 0,
      "nextStep": "3 previews ready to watch, 39 people waiting on an approval.",
      "createdAt": "2026-08-13T10:05:44.000Z" }
  ]
}

nextStep exists because a script that stops halfway leaves a person with no record of where they were. It is written for a human and its wording will change.

Start a campaign on a recording that already exists. Writes.

{ "id": "3b7e...", "name": "Series A ops leads",
  "templateId": "9f1c...", "status": "draft" }

Add people. Send { "people": [...] }, or a single person object at the top level, whichever your tool produces. Up to 1000 per call. Writes.

Nothing is charged here. Everything is optional, but a video with no first name has nothing to personalize.

The reply carries each person's id and their page URL, both usable immediately. The page is live before the video exists: it shows a personalized holding screen until the render lands, so you can write the link into a row on this first call and never poll for it.

{
  "added": 1, "skipped": 0, "total": 42,
  "people": [
    { "id": "b77d0a89-e98f-46a0-a3f3-efadddacb434",
      "firstName": "Sofia", "company": "Grab",
      "url": "https://vid.personade.com/p/sofia-lbGRs_NOzRrpuOU4",
      "videoUrl": "https://vid.personade.com/p/sofia-lbGRs_NOzRrpuOU4/video" }
  ]
}

skipped is people already in this campaign. They are not added again, because again means a second video and a second credit, but they still come back in people with the id and URL they already had. Re-running the same row is safe and returns the same answer.

What generating would cost. Charges nothing.

Render the first few so somebody can watch one. Charges. Writes.

{ "campaignId": "3b7e...", "made": 3, "creditsCharged": 3 }

Charge for everyone still waiting and start the renders. This is the one that spends. Writes.

{ "campaignId": "3b7e...", "started": 40, "creditsCharged": 48 }

creditsCharged is what was taken, not what was quoted. That is the number to repeat to a person.

Where a campaign has got to. Poll this every 30 seconds or so while renders run.

{
  "id": "3b7e...", "name": "Series A ops leads", "status": "rendering",
  "counts": { "total": 40, "pending": 0, "rendering": 12, "complete": 28,
              "failed": 0, "cancelled": 0, "skipped": 0 },
  "stages": { "lipsync": 9, "compose": 3 }
}

stalledappears when our side has stopped moving. Wire an alert to it: from the outside a dead queue and a slow one look identical, and without this a poller reports "28 of 40 done" in a patient tone until somebody notices. Full detail on Polling and delivery.

One person, by the id you got when you added them. Use this rather than filtering the campaign list: an id cannot be matched to the wrong person, and two Daniels at two companies can.

{
  "id": "b77d0a89-...", "firstName": "Sofia", "company": "Grab",
  "campaignId": "3b7e...", "status": "pending",
  "url": "https://vid.personade.com/p/sofia-lbGRs_NOzRrpuOU4",
  "videoUrl": "https://vid.personade.com/p/sofia-lbGRs_NOzRrpuOU4/video",
  "videoReady": false
}

The finished links, up to 500. Only videos that are done, on pages that still work.

Useful for collecting a whole campaign at the end. For one person, use GET /leads/{id} instead: this returns the campaign as a list, so picking one out means matching on name and company, which is a guess.

Cancel what has not started and refund it. Writes.

{ "campaignId": "3b7e...", "stopped": 22,
  "stillRendering": 3, "status": "stopped" }

stillRenderingis the number that cannot be recalled. They finish and their credits stand. Say it out loud: "I stopped it" while three videos are on their way to real prospects is the kind of true-ish answer that costs somebody their credibility rather than only their credits.