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,
    "transfer_enabled": false,
    "transfer_number": "+4795837050"
}'

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-11-30 23:12:05

List all agents for tenant

Get agent details