Create Agent

curl -X POST https://api.telzino.com/v1/agents \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Support Agent",
    "organizationId": "987fcdeb-51a2-3bc4-d567-890123456789",
    "ragEnabled": true,
    "knowledgeBaseId": "11111111-1111-1111-1111-111111111111",
    "ragConfig": { "top_k": 5, "rewrite_query": true }
  }'

curl -X POST https://api.telzino.com/v1/agents \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Customer Support Agent",
    "organizationId": "123e4567-e89b-12d3-a456-426614174000",
    "description": "Handles customer inquiries and support requests",
    "greetingMessage": "Hello! Thank you for calling Acme Corp. How can I help you today?",
    "systemPrompt": "You are a helpful customer support agent for Acme Corp. Be friendly and professional. If the customer needs to speak with a human, use the transfer_call function.",
    "agentType": "simple",
    "model": "gpt-4.1",
    "ttsModel": "cartesia",
    "voiceSettings": {"voice_id": "f786b574-daa5-4673-aa0c-cbe3e8534c02", "speed": 1.0},
    "transferEnabled": true,
    "transferRules": "Transfer to +15551234567 if the caller asks for billing support",
    "language": "en-US",
    "timezone": "America/New_York",
    "enableRecording": true,
    "knowledgebaseLinks": ["https://example.com/faq", "https://example.com/pricing"],
    "email": ["[email protected]"]
  }'

curl -X POST https://api.telzino.com/v1/agents \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Support Agent with Integrations",
    "organizationId": "123e4567-e89b-12d3-a456-426614174000",
    "systemPrompt": "You are a helpful customer support agent. After every call, create a ticket using the Create_Ticket tool.",
    "model": "gpt-4.1",
    "ttsModel": "cartesia",
    "voiceSettings": {"voice_id": "f786b574-daa5-4673-aa0c-cbe3e8534c02"},
    "language": "en-US",
    "timezone": "America/New_York",
    "extensions": {
      "tools": [
        {
          "type": "webhook",
          "name": "Create_Ticket",
          "friendlyName": "Create Support Ticket",
          "description": "Creates a support ticket in Freshdesk after every call",
          "condition": "after_call",
          "method": "POST",
          "url": "https://yourcompany.freshdesk.com/api/v2/tickets",
          "headers": [
            { "key": "Authorization", "value": "Basic YOUR_FRESHDESK_API_KEY" },
            { "key": "Content-Type", "value": "application/json" }
          ],
          "parameters": [
            { "key": "subject", "value": "" },
            { "key": "description", "value": "" },
            { "key": "customer_email", "value": "" },
            { "key": "priority", "value": "2" }
          ]
        }
      ],
      "mcp_servers": [
        {
          "name": "Acme CRM",
          "url": "https://mcp.acmecrm.com/sse",
          "transport_type": "sse",
          "auth_headers": [
            { "key": "Authorization", "value": "Bearer YOUR_CRM_TOKEN" }
          ]
        }
      ]
    }
  }'

const response = await fetch('https://api.telzino.com/v1/agents', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'Customer Support Agent',
    organizationId: '123e4567-e89b-12d3-a456-426614174000',
    description: 'Handles customer inquiries',
    greetingMessage: 'Hello! How can I help you today?',
    systemPrompt: 'You are a helpful customer support agent...',
    agentType: 'simple',
    model: 'gpt-4.1',
    ttsModel: 'cartesia',
    voiceSettings: { voice_id: 'f786b574-daa5-4673-aa0c-cbe3e8534c02', speed: 1.0 },
    transferEnabled: true,
    transferRules: 'Transfer to +15551234567 if the caller asks for billing support',
    language: 'en-US',
    timezone: 'America/New_York',
    enableRecording: true,
    knowledgebaseLinks: ['https://example.com/faq', 'https://example.com/pricing'],
    email: ['[email protected]']
  })
});

const { data } = await response.json();

import requests

response = requests.post(
    'https://api.telzino.com/v1/agents',
    headers={'Authorization': 'Bearer YOUR_ACCESS_TOKEN'},
    json={
        'name': 'Customer Support Agent',
        'organizationId': '123e4567-e89b-12d3-a456-426614174000',
        'description': 'Handles customer inquiries',
        'greetingMessage': 'Hello! How can I help you today?',
        'systemPrompt': 'You are a helpful customer support agent...',
        'agentType': 'simple',
        'model': 'gpt-4.1',
        'ttsModel': 'cartesia',
        'voiceSettings': {'voice_id': 'f786b574-daa5-4673-aa0c-cbe3e8534c02', 'speed': 1.0},
        'transferEnabled': True,
        'transferRules': 'Transfer to +15551234567 if the caller asks for billing support',
        'language': 'en-US',
        'timezone': 'America/New_York',
        'enableRecording': True,
        'knowledgebaseLinks': ['https://example.com/faq', 'https://example.com/pricing'],
        'email': ['[email protected]']
    }
)

agent = response.json()['data']

{
  "data": {
    "id": "abc12345-e89b-12d3-a456-426614174000",
    "organization_id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "Customer Support Agent",
    "description": "Handles customer inquiries",
    "greeting_message": "Hello! How can I help you today?",
    "system_prompt": "You are a helpful customer support agent...",
    "agent_type": "simple",
    "model": "gpt-4.1",
    "voice_model": "gpt-4o-realtime-preview",
    "stt_model": "deepgram",
    "tts_model": "cartesia",
    "voice_settings": {"voice_id": "f786b574-daa5-4673-aa0c-cbe3e8534c02", "speed": 1.0},
    "config": {},
    "extensions": {},
    "integrations": {},
    "transfer_enabled": true,
    "transfer_rules": "Transfer to +15551234567 if the caller asks for billing support",
    "language": "en-US",
    "timezone": "America/New_York",
    "enable_recording": true,
    "echo_detection": false,
    "call_detection": false,
    "knowledgebase_links": ["https://example.com/faq", "https://example.com/pricing"],
    "email": ["[email protected]"],
    "email_tool_enabled": false,
    "email_server_id": null,
    "pronunciations": [],
    "status": "active",
    "is_active": true,
    "created_at": "2024-01-15T10:30:00Z",
    "updated_at": "2024-01-15T10:30:00Z"
  }
}

{
  "error": "Invalid request data",
  "details": [
    {"path": ["name"], "message": "Name is required"}
  ]
}

{
  "error": "forbidden",
  "error_description": "No access to this organization"
}

{
  "error": "forbidden",
  "error_description": "Model not available for this organization: claude-sonnet-4-6"
}

{
  "error": "forbidden",
  "error_description": "TTS provider not available for this organization: minimax"
}

{
  "error": "forbidden",
  "error_description": "Feature(s) not available for this organization: listings_search"
}

{
  "error": "forbidden",
  "error_description": "Screenshare requires a model that can read images. Choose a different model, or turn screenshare off."
}

{
  "error": "forbidden",
  "error_description": "Screenshare is not available for healthcare organizations."
}