Skip to main content
POST

Path Parameters

string
required
The agent that will make the call (UUID format). Must be a Telzino AI agent you have access to.

Request Body

string
required
Destination phone number in E.164 format, e.g. +18135551234. Numbers in any other format are rejected with 400.
string
Context for this specific call, appended to the agent’s system prompt (max 4000 characters). Use it to tell the agent who it’s calling and why.Example: "You are calling John Smith to confirm his appointment tomorrow at 2pm. If he can't make it, offer Thursday at 10am."
string
Exact opening line the agent speaks when the callee answers (max 1000 characters). Overrides the agent’s Outbound Greeting setting and the auto-generated opener.Example: "Hi, this is Ava calling from Acme Corp about your appointment."Greeting precedence when the callee answers: this greeting field → the agent’s Outbound Greeting setting → an AI-generated opener composed from call_context → the agent’s inbound greeting message.
object
Opaque JSON object (max 16KB serialized) stored with the call and echoed back verbatim in the result webhook and call record — use it to correlate the call with records in your system (CRM IDs, campaign IDs, etc.).
string
HTTPS URL that receives the result webhook when the call reaches a terminal state. Must use https://; URLs resolving to private networks are rejected.

Response

Returns 202 Accepted immediately — the call is queued and dials within a few seconds.
string
The outbound call ID. Use it to poll status via Get Outbound Call.
string
Always queued on creation. See the call lifecycle for the full status progression.
string
Internal call room identifier (also appears on the linked call log).
string
ISO 8601 timestamp of when the call was queued.