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

POST

/api/calls/outbound-dynamic

Build and use an agent on-the-fly from JSON config (not from database).

Perfect for:

Testing new agent configurations live

Campaign-specific agents

A/B testing different agent configs

Dynamic personalization per customer

NEW: Dynamic Variables 🆕
Full template support with LiquidJS:

Use {{variableName}} in instructions, greeting_message, recording_prompt

Conditionals: {% if condition %}...{% endif %}

Date formatting: {{"now" | date: "%d.%m.%Y", "Europe/Oslo"}}

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

See full documentation at /DYNAMIC-VARIABLES-GUIDE.md

Request

Authorization

API Key

Add parameter in header

X-API-Key

Example:

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

Body Params application/jsonRequired

Examples

Responses

🟢200Success

application/json

Dynamic call started successfully

Body

🟠403403

Request Example

Shell

JavaScript

Java

Swift

cURL

Simple ad-hoc agentOrder confirmation with dynamic variablesAppointment reminder with time-based greetingCampaign bot with webhook integration

curl --location --request POST 'https://snakk-backend-production.up.railway.app/api/calls/outbound-dynamic' \
--header 'X-API-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "toNumber": "+4712345678",
    "agentConfig": {
        "instructions": "Du er en test bot. Si hei og still ett spørsmål.",
        "voice": "marin",
        "recording_enabled": false
    }
}'

Response Example

{
    "success": true,
    "call": {},
    "room": "string",
    "sipCallId": "string"
}

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

Start outbound call from database agent

List your phone numbers