Skip to main content
POST
Create Persona Call

Authorizations

X-API-Key
string
header
required

Workspace API key (e.g. kej_live_...)

Body

application/json

Persona call creation — requires persona_id, inherits full settings hierarchy.

persona_id
string
required

Persona to use

contact_id
string | null

Existing contact ID

contact
ContactInput · object | null

New contact to create inline

agent_id
string | null

Voice agent ID

phone_number_id
string | null

Pin a specific origin phone number

schedule_at
string<date-time> | null

Schedule for later

priority
integer
default:50

Queue priority

Required range: 0 <= x <= 100
config
CallConfig · object | null

Overrides on top of settings hierarchy

external_reference
string | null

External tracking ID

Maximum string length: 255
context
Context · object | null

Template variables

Response

Successful Response

Response after creating a call via public API.

id
string
required

Call ID

contact_id
string
required

Contact ID

status
string
required
created_at
string<date-time>
required
scheduled_at
string<date-time> | null