Skip to main content
POST
/
call
/
trigger
cURL
curl --request POST \
  --url https://api.samora.ai/v1/call/trigger \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "to_number": "<string>",
  "metadata": {}
}
'
{
  "message": "Call request accepted",
  "status": "accepted",
  "call_id": "550e8400-e29b-41d4-a716-446655440000"
}

Authorizations

​
X-API-Key
string
header
required

Your unique organization API key. Required on all requests.

Body

application/json
​
agent_id
string<uuid>
required

The UUID of the AI agent to conduct the call.

​
to_number
string
required

The destination phone number in E.164 format (e.g. +919876543210). Must include country code. Pattern: + followed by 10–15 digits.

Pattern: ^\+[0-9]{10,15}$
​
metadata
object

Optional. Additional metadata to pass context to the agent (e.g. customer information, call objectives). Arbitrary key-value pairs.

Response

Call request accepted and queued

​
message
string
required

Human-readable status message.

​
status
string
required

Status value, e.g. accepted.

Example:

"accepted"

​
call_id
string<uuid>
required

The unique identifier for the call (UUID). Use this to fetch call details later.