Calls

Initiate outbound calls

Initiate Outbound Call

post

Initiate an outbound call from an organization phone number to a specific contact.

Authorizations

OrganizationApiToken

AuthorizationstringRequired

Organization API Token.

Paste only your token in the field below — the Bearer prefix is added automatically by the docs UI and in every generated code sample. The final header sent is:

Authorization: Bearer {orgId}.{secretToken}

Token format: {orgId}.{secretToken} — example: 15c94c3c-1873-4a09-bfbb-03357c29ea50.abc123xyz.

JWT tokens are NOT accepted.

Body

application/json

fromNumberIdstringRequired

Phone number integration ID to call from (required)

Example: num_123

contactIdstringRequired

Contact ID to call (required)

Example: con_1

campaignIdstringOptional

Campaign ID for tracking (optional)

Example: cmp_123

Responses

200

Call initiated

application/json

Other propertiesanyOptional

post/api/calls/outbound

HTTPcURLJavaScriptPython

POST /api/calls/outbound HTTP/1.1
Host: api.agentalk.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 69

{
  "fromNumberId": "num_123",
  "contactId": "con_1",
  "campaignId": "cmp_123"
}

200

Call initiated

{
  "callId": "call_abc123",
  "status": "initiated",
  "roomName": "phone-call-outbound_<voicebot_id>_<phone>_<call_id>_<ts>_api",
  "fromNumber": "[phone]",
  "toNumber": 987654321,
  "contactId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "voicebotId": "v1o2i3c4-e5b6-7890-abcd-ef1234567890",
  "campaignId": "c1a2m3p4-a5i6-7890-abcd-ef1234567890"
}