Skip to main content
POST
/
calls
curl --request POST \
  --url https://api.truedy.ai/api/public/v1/calls \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "agent_id": "agt_f9447372",
  "phone_number": "+15551234567"
}
'
{
  "data": {
    "id": "call_a1b2c3d4",
    "agent_id": "agt_f9447372",
    "phone_number": "+15551234567",
    "direction": "outbound",
    "status": "queued",
    "created_at": "2026-03-03T20:24:55.310278Z"
  },
  "meta": {
    "request_id": "req_32e7531c-8",
    "ts": "2026-03-03T20:24:55.310278Z"
  }
}

Authorizations

​
Authorization
string
header
required

API key authentication. Include your API key in the Authorization header: Bearer <your_api_key>

Headers

​
X-Idempotency-Key
string

Optional idempotency key for safe retries

Body

application/json
​
agent_id
string
required

Agent ID to use for the call

Example:

"agt_f9447372"

​
phone_number
string
required

Destination phone number in E.164 format

Pattern: ^\+[1-9]\d{1,14}$
Example:

"+15551234567"

​
from_number
string | null

Caller ID / originating number in E.164 format. Must be assigned to the agent. If omitted, system picks automatically.

Pattern: ^\+[1-9]\d{1,14}$
Example:

"+15559876543"

​
call_settings
object | null

Optional per-call settings

​
variables
object | null

Custom key-value variables for template substitution in prompts

Example:
{
  "first_name": "John",
  "company_name": "Acme Corp"
}

Response

Call created successfully

​
data
object
required
​
meta
object
required