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-5abc-4def-9012-abcdef123456",
  "phone_number": "+12125551234"
}
'
{
  "data": {
    "id": "call_88333dcb-b",
    "agent_id": "agt_f9447372-5",
    "status": "queued",
    "from_number": "+12125551235",
    "to_number": "+12125551234",
    "direction": "outbound",
    "created_at": "2026-03-03T20:30:21.310278Z"
  },
  "meta": {
    "request_id": "req_32e7531c-8",
    "timestamp": "2026-03-03T20:30:21.310278Z"
  }
}

Authorizations

​
Authorization
string
header
required

Your API key. Get it from the Truedy Dashboard. Send as: Authorization: Bearer <your_key>

Headers

​
X-Idempotency-Key
string | null

Unique key to prevent duplicate call creation. If you retry with the same key, you get back the original response.

Body

application/json

Create an outbound call. Organization is set from your API key; direction is always outbound.

from_number behaviour:

  • If you provide from_number, the system validates it belongs to your organisation and uses it as the caller ID.
  • If you omit from_number, the system automatically selects one of the phone numbers assigned to this agent for outbound calls.
  • If no numbers are assigned to the agent at all, the call will fail with a clear error message.
​
agent_id
string
required

The ID of the agent that will handle the call

​
phone_number
string
required

Destination phone number in E.164 format (the number to call)

Pattern: ^\+[1-9]\d{1,14}$
​
from_number
string | null

Caller ID / originating phone number in E.164 format. Must be a number assigned to your agent. If omitted, the system automatically picks from the agent's assigned outbound numbers.

Pattern: ^\+[1-9]\d{1,14}$
​
call_settings
PublicCallSettings · object

Optional per-call settings (recording, greeting, timeouts)

​
variables
Variables · object

Key-value pairs for mustache template substitution in agent prompts (e.g. first_name, company)

Response

Resource created successfully

Response body