Create new agent

POST

/api/agents

Creates a new voice agent. After creation, add tools/webhooks via POST /api/agents/{agentId}/tools endpoint.

Request

Authorization

API Key

Add parameter in header

X-API-Key

Example:

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

Body Params application/jsonRequired

Examples

Responses

🟢201Success

application/json

Agent created successfully. Next: Add phone number and tools.

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://snakk-backend-production.up.railway.app/api/agents' \
--header 'X-API-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "Support Agent",
    "description": "Handles customer support inquiries",
    "instructions": "Du er en hjelpsom support agent. Du snakker norsk og hjelper kunder med spørsmål.",
    "voice": "marin",
    "language": "no",
    "recording_enabled": true,
    "silent_recording_enabled": false,
    "recording_prompt": "Denne samtalen kan bli tatt opp. Er det greit for deg?",
    "greeting_message": "Hei! Velkommen til kundeservice. Hva kan jeg hjelpe deg med?",
    "greeting_speaks_first": true,
    "transfer_enabled": false,
    "transfer_number": "+4795837050",
    "knowledge_base_enabled": false,
    "allowed_embed_domains": [
        "example.com",
        "*.mycompany.no"
    ],
    "human_handoff_enabled": false,
    "human_handoff_message": "Connecting you to a representative...",
    "no_operator_message": "No operators available. Please leave your contact info.",
    "vad_type": "server_vad",
    "turn_detection_settings": {
        "threshold": 0.6,
        "prefix_padding_ms": 400,
        "silence_duration_ms": 700
    }
}'

Response Example

{
    "agent": {
        "id": "agent-uuid",
        "tenant_id": "tenant-uuid",
        "name": "Support Agent",
        "is_active": true,
        "created_at": "2025-11-23T10:00:00Z"
    }
}

Modified at 2025-12-17 20:24:06

List all agents for tenant

Get agent details