Start outbound call from database agent

POST

/api/calls/outbound

Start an outbound call using an existing agent from your database.

NEW: Dynamic Variables 🆕
Personalize agent messages with custom data:

Use {{variableName}} in agent instructions, greeting, recording prompt

Pass variables in dynamicVariables object

Default variables always available: {{now}}, {{date}}, {{time}}, {{customer.number}}

Example with variables:
Agent instructions: "Du ringer {{name}} for å minne om avtale {{appointmentDate}}"
API call includes: { "dynamicVariables": { "name": "Ola", "appointmentDate": "15. januar" } }

Request

Authorization

API Key

Add parameter in header

X-API-Key

Example:

X-API-Key: ********************

Body Params application/jsonRequired

Examples

Responses

🟢200Success

application/json

Call started successfully

Body

🟠403403

🟠404404

Request Example

Shell

JavaScript

Java

Swift

cURL

Simple call without variablesAppointment reminder with variablesOrder confirmation with nested variables

curl --location --request POST 'https://snakk-backend-production.up.railway.app/api/calls/outbound' \
--header 'X-API-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "agentId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "toNumber": "+4712345678"
}'

Response Example

{
    "success": true,
    "call": {
        "id": "string",
        "room_name": "string",
        "status": "string"
    },
    "room": "string",
    "sipCallId": "string"
}

Modified at 2025-11-30 23:12:05

Add tool/webhook to agent

Start outbound call with ad-hoc agent config (JSON)