Initiate Agent Call

Initiates an outgoing PSTN call handled by a human agent on your team — not the AI bot. It dials your agent's phone first, then the customer's phone, and connects the two legs once the agent picks up.

Endpoint

POST https://public.doubletick.io/v1/calls/agent

Authentication

Include your API key in the Authorization header.

📘

NOTE

If you do not have your DoubleTick API Key, you can obtain it by following this guide link.

Request Body

Example Request

curl --request POST \
  --url https://public.doubletick.io/v1/call/agent-call \
  --header 'Authorization: <your-api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
    "channel": "PSTN",
    "from": "+911234567890",
    "to": "+919876543210",
    "agentNumber": "+919812345678"
  }'

Example Response

{
  "success": true,
  "data": {
    "callId": "call_xyz789",
    "pstnPhoneNumber": "+911234567890"
  },
  "customer": {
    "name": "John Doe",
    "phoneNumber": "+919876543210"
  }
}

Response Fields

data

customer

Error Responses

Things to Know

• The agentNumber field is required — there is no default/fallback agent.
• channel must be exactly PSTN (case-sensitive). PSTN only value accepted.
• agentNumber must match exactly one active member of your org by phone number.
• The agent must also have calling permission on the PSTN integration tied to from.
• This endpoint is for human-agent calls only. AI-handled calls use a different endpoint (link).