Skip to main content
POST
/
v1
/
agents
/
{agentId}
/
outbound-calls
curl -X POST "https://api.telzino.com/v1/agents/123e4567-e89b-12d3-a456-426614174000/outbound-calls" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "to_number": "+18135551234",
    "call_context": "You are calling John to confirm his appointment tomorrow at 2pm.",
    "metadata": { "crm_id": "123" },
    "callback_url": "https://your-system.com/telzino/call-result"
  }'

{
  "id": "0fc6daf8-7251-4553-9488-867ba0b82d8e",
  "status": "queued",
  "room_name": "agent-123e4567-e89b-12d3-a456-426614174000-out-0fc6daf8-7251-4553-9488-867ba0b82d8e",
  "created_at": "2026-06-11T12:49:28.898751+00:00"
}

​
Path Parameters

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

​
Request Body

​
to_number
string
required
Destination phone number in E.164 format, e.g. +18135551234. Numbers in any other format are rejected with 400.
​
call_context
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."
​
metadata
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.).
​
callback_url
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.
​
id
string
The outbound call ID. Use it to poll status via Get Outbound Call.
​
status
string
Always queued on creation. See the call lifecycle for the full status progression.
​
room_name
string
Internal call room identifier (also appears on the linked call log).
​
created_at
string
ISO 8601 timestamp of when the call was queued.
curl -X POST "https://api.telzino.com/v1/agents/123e4567-e89b-12d3-a456-426614174000/outbound-calls" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "to_number": "+18135551234",
    "call_context": "You are calling John to confirm his appointment tomorrow at 2pm.",
    "metadata": { "crm_id": "123" },
    "callback_url": "https://your-system.com/telzino/call-result"
  }'

{
  "id": "0fc6daf8-7251-4553-9488-867ba0b82d8e",
  "status": "queued",
  "room_name": "agent-123e4567-e89b-12d3-a456-426614174000-out-0fc6daf8-7251-4553-9488-867ba0b82d8e",
  "created_at": "2026-06-11T12:49:28.898751+00:00"
}