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"
  }'

const agentId = '123e4567-e89b-12d3-a456-426614174000';

const response = await fetch(
  `https://api.telzino.com/v1/agents/${agentId}/outbound-calls`,
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      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',
    }),
  }
);

const call = await response.json();
console.log(`Call ${call.id} queued`);

import requests

agent_id = '123e4567-e89b-12d3-a456-426614174000'

response = requests.post(
    f'https://api.telzino.com/v1/agents/{agent_id}/outbound-calls',
    headers={'Authorization': 'Bearer YOUR_ACCESS_TOKEN'},
    json={
        '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',
    },
)

call = response.json()
print(f"Call {call['id']} queued")

{
  "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"
}

{
  "error": "invalid_request",
  "error_description": "to_number must be E.164 (e.g. +15105550123)"
}

{
  "error": "consent_required",
  "error_description": "This agent requires a consent_basis on every outbound call"
}

{
  "error": "not_found",
  "error_description": "Agent not found or access denied"
}

{
  "error": "policy_violation",
  "error_description": "+18135551234 has reached its 3 attempts per day"
}

{
  "error": "suppressed",
  "error_description": "+18135551234 is on the organization's outbound suppression list"
}

{
  "error": "out_of_window",
  "error_description": "It is 22:14 for the callee; calls are allowed 08:00-21:00"
}

{
  "error": "agent_at_capacity",
  "error_description": "Agent is at its concurrent-call limit; retry later"
}