Reference
Limits
Every cap in one place, with what happens when you reach it. Some refuse the request. Some quietly trim the value, which is the more dangerous kind, so those are marked.
Requests
| Limit | Cap | What happens |
|---|---|---|
| Requests per API key | 120 per minute | 429 with rate_limited. Wait and retry. |
| Keys created per workspace | 10 per hour | The Account page refuses. It is a fuse against a script, not a quota. |
The rate limit is per key rather than per account, so one busy integration cannot lock you out of the others. It is a fixed window, not a leaky bucket: 120 in the first second of a minute is allowed, and the 121st is refused until the minute turns.
Payloads
| Limit | Cap | What happens |
|---|---|---|
| People per add-leads call | 1000 | 400 with bad_input. Split and repeat. |
| Hook | 200 characters | Trimmed silently. About 12 seconds of speech. |
| First name | 80 characters | Trimmed silently. |
| Company | 120 characters | Trimmed silently. |
| Role | 120 characters | Trimmed silently. |
| 254 characters | Trimmed silently. The practical RFC maximum. | |
| Website and profile URL | 500 characters | Trimmed silently. |
| CTA label | 40 characters | Trimmed silently. It is a button; longer wraps and the page stops looking deliberate. |
| CTA URL | 500 characters | Trimmed silently. |
| Headline | 160 characters | Trimmed silently. Room for a sentence with {name} and {company} in it, not a paragraph. |
| Campaign name | 80 characters | Trimmed silently. |
| Campaign goal | 500 characters | Trimmed silently. |
Every field is also stripped of control characters, zero-width marks and bare URLs before it is stored. The last one is deliberate: a voice reading "h-t-t-p-s colon" is nobody's idea of personal.
Responses
| Limit | Cap | What happens |
|---|---|---|
| Recordings per templates call | 50 | Older ones are omitted. A workspace has a handful, not thousands. |
| Campaigns per list call | 100, default 25 | ?limit= above 100 is clamped to 100, not rejected. |
| Links per videos call | 500 | A campaign larger than this cannot be collected in full. Split it. |
Spending
| Limit | Cap | What happens |
|---|---|---|
| Credits per key per day | Whatever you set when you made the key | 429 with cap_reached. Resets at midnight UTC. Cannot be raised by the key itself. |
| Preview videos per campaign | 3 | Preview renders the first few and stops. It is a sample, not a batch. |
| Credits available | Your balance | 402 with insufficient_credits. Nothing is half-charged. |
One credit is one person and one video. The extra charge worth knowing about is the verified-email lookup: leads imported from our database cost one extra credit per five people, collected once per campaign by whichever render happens first. That is the gap between low and high in an estimate.
Start building
Ready to build?
Make a key in Personade,
or have us walk you through the integration on a call.