Skip to main content
POST
/
api
/
calls
/
outbound
Trigger outbound call
curl --request POST \
  --url https://api.recepta.ai/api/v1/api/calls/outbound \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "toNumber": "+15551234567",
  "fromNumber": "+15559876543",
  "agentId": "agent_abc123",
  "metadata": {}
}
'
{
  "success": true,
  "message": "Call initiated successfully",
  "data": {
    "call": {
      "id": "69af1467f97caa0d0e1e13e2",
      "retellId": "call_abc123",
      "callType": "PHONE_CALL",
      "direction": "INBOUND",
      "fromNumber": "+19032466065",
      "toNumber": "+19034851458",
      "status": "ENDED",
      "startTimestamp": "2026-03-09T18:41:43.188Z",
      "endTimestamp": "2026-03-09T18:41:49.664Z",
      "durationMs": 6476,
      "companyId": "69053acd6e4cdf19cb778090",
      "createdAt": "2023-11-07T05:31:56Z"
    }
  }
}

Authorizations

​
x-api-key
string
header
required

Your Recepta API key (starts with rcp_)

Body

application/json
​
toNumber
string
required

Destination phone number (E.164)

Example:

"+15551234567"

​
fromNumber
string
required

Your Recepta phone number (E.164)

Example:

"+15559876543"

​
agentId
string

Agent to use (optional, defaults to company agent)

Example:

"agent_abc123"

​
metadata
object

Custom metadata to attach to the call

Response

Call initiated

​
success
boolean
Example:

true

​
message
string
Example:

"Call initiated successfully"

​
data
object