curl --request POST \
--url 'https://api.voice.stateset.com/api/v1/make-call' \
--header "Authorization: Bearer $STATESET_VOICE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"agent_key": "support_primary",
"from": "+15555551234",
"greeting": "Hi, this is Acme Dental calling about your appointment.",
"org_id": "org-456",
"to": "+15555555678"
}'
{
"call_sid": "CA1234567890abcdef1234567890abcdef",
"from": "+15555551234",
"ok": true,
"status": "queued",
"to": "+15555555678"
}
Make Call
Tenant-scoped voice call operation for starting outbound AI calls or coordinating Twilio call setup.
POST
/
api
/
v1
/
make-call
curl --request POST \
--url 'https://api.voice.stateset.com/api/v1/make-call' \
--header "Authorization: Bearer $STATESET_VOICE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"agent_key": "support_primary",
"from": "+15555551234",
"greeting": "Hi, this is Acme Dental calling about your appointment.",
"org_id": "org-456",
"to": "+15555555678"
}'
{
"call_sid": "CA1234567890abcdef1234567890abcdef",
"from": "+15555551234",
"ok": true,
"status": "queued",
"to": "+15555555678"
}
Tenant-scoped voice call operation for starting outbound AI calls or coordinating Twilio call setup.
Request body
MakeCallRequest
Transient inline agent config for THIS call only (same shape and validation as
POST /voice/agents config, including custom tools). Mutually exclusive with agent_version_id.Opaque caller-supplied metadata (e.g. campaign ids). A JSON object of at most 4 KB; persisted on the outbound attempt row and inherited by retry children.
Terminal outcomes that should trigger a retry:
no_answer, busy, failed, or voicemail (snake_case). Ignored when max_attempts == 1.Response
MakeCallResponse
Status codes
| Code | Meaning |
|---|---|
200 | Outbound call initiated |
400 | Bad request |
409 | Same Idempotency-Key currently in flight |
500 | Internal server error |
503 | Twilio not configured |
curl --request POST \
--url 'https://api.voice.stateset.com/api/v1/make-call' \
--header "Authorization: Bearer $STATESET_VOICE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"agent_key": "support_primary",
"from": "+15555551234",
"greeting": "Hi, this is Acme Dental calling about your appointment.",
"org_id": "org-456",
"to": "+15555555678"
}'
{
"call_sid": "CA1234567890abcdef1234567890abcdef",
"from": "+15555551234",
"ok": true,
"status": "queued",
"to": "+15555555678"
}
Last modified on August 31, 2026