Skip to main content
POST
cURL

Authorizations

X-API-Key
string
header
required

Your unique organization API key. Required on all requests.

Body

application/json
agent_id
string<uuid>
required

The UUID of the AI agent to conduct the call.

to_number
string
required

The destination phone number in E.164 format (e.g. +919876543210). Must include country code. Pattern: + followed by 10-15 digits.

Pattern: ^\+[0-9]{10,15}$
metadata
object

Optional. Additional metadata to pass context to the agent (e.g. customer information, call objectives). Arbitrary key-value pairs.

Response

Call request accepted and queued

message
string
required

Human-readable status message.

status
string
required

Status value, e.g. accepted.

Example:

"accepted"

call_id
string<uuid>
required

The unique identifier for the call (UUID). Use this to fetch call details later.