Sign in
calls

Place a call

Place an outbound AI phone call. Two request shapes - freeform (target_phone + brief) or structured (target_phone + intent + slots). See the guide above for the 422 slot-retry loop.

post/calls

Headers

X-API-Keystring nullable

Request body

OR

Example request

{
  "target_phone": "+15551234567"
}

Response

Call created. The envelope shape depends on which request path was used - freeform returns CallResponse (a call wrapper), structured returns the flat SkillRunResponse (top-level call_id, no wrapper). Either way, poll GET /calls/{call_id} afterward - that response is identical regardless of which path created the call.

OR

Example response

{
  "call": {
    "call_id": "c_abc123",
    "customer_id": "cus_xyz",
    "task_id": "t_abc123",
    "target_phone": "+15551234567",
    "call_sid": "CAxxxxxxxx"
  },
  "credits_reserved": 10,
  "credits_charge_on_success": 10
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.