Enqueue a single outbound call
Enqueue ONE outbound voice call to a recipient. The call is not placed inline: this writes a normalized intent that the outbound worker schedules, compliance-gates (informational-only, callee quiet-hours, internal opt-out, and — for a consumer audience — a resolved consent basis), and dials when due; an answered call is billed per minute. message_category is always informational. A consumer audience requires a resolved consentBasis (pewc, express, or ebr); none is only valid for a business audience. Send an Idempotency-Key to make a retry safe; identical requests also collapse to one intent via a deterministic dedupe key. Returns 202 with the intent id.
Authorizations
Clerk JWT (browser). Requires Authorization: Bearer <clerk_jwt> and the X-Organization-Id header. Validated by the ported Clerk middleware, which sets the app.current_organization_id RLS context.
Headers
Client-supplied idempotency key on mutating POSTs (API-First).
Body
The agent that places the call (must belong to your org).
The caller-ID number id — an org-owned, trunk-provisioned DID.
The recipient phone number; normalized to E.164 (an invalid number is rejected 400).
The lawful basis to place this call. A consumer audience REQUIRES a resolved basis (pewc, express, or ebr); none is only valid for a business audience.
pewc, express, ebr, none Optional recipient name (also a merge variable for the greeting).
Optional merge variables for the greeting / playbook.
consumer, business