Create agent

POST

https://api.levrage.ai/v1/agents

POST

/v1/agents

import requests
url = "https://api.levrage.ai/v1/agents"
payload = {
    "name": "Acme Sales Agent",
    "agent_type": "sales",
    "sector": "Finance & Banking",
    "ai_model": "lai-premium-2",
    "language": "English",
    "start_flow": "Hello! I'm calling from Acme Finance. Am I speaking with the right person?",
    "end_flow": "Thank you for your time! Have a great day.",
    "tone": "professional",
    "voice": "female",
    "voice_response_settings": {
        "allow_user_to_interrupt": True,
        "words_to_interrupt": 2,
        "fast_response": True,
        "remind_on_silence": True,
        "silence_before_reminder": 10,
        "max_reminders": 3,
        "max_call_duration_minutes": 15,
        "response_creativity": 0.8
    },
    "details_to_collect": [
        {
            "key": "full_name",
            "type": "text",
            "description": "Customer's full name"
        },
        {
            "key": "monthly_income",
            "type": "number",
            "description": "Monthly income in INR"
        },
        {
            "key": "email",
            "type": "email",
            "description": "Email address for follow-up"
        }
    ],
    "brand_name": "Acme Finance",
    "typed_knowledge": "Personal loan products from 50,000 to 25,00,000 INR. Interest rates starting at 10.5% p.a.",
    "timezone": "Asia/Kolkata",
    "webhook_config": {
        "url": "https://api.yourcompany.com/webhooks/levrage",
        "events": ["call.completed", "call.failed"]
    },
    "lookup_api": {
        "enabled": True,
        "api_name": "Customer CRM Lookup",
        "api_url": "https://api.yourcompany.com/customers",
        "method": "GET",
        "query_params": [
            {
                "key": "phone",
                "value": "{number}",
                "is_variable": True
            }
        ],
        "headers": [
            {
                "key": "Authorization",
                "value": "Bearer your_crm_api_key",
                "is_variable": False
            }
        ],
        "timeout_seconds": 10,
        "retry_count": 1
    },
    "transfer_map": [
        {
            "name": "Sales Manager",
            "number": "9876543210",
            "country_code": "+91",
            "category": "escalation"
        }
    ],
    "other_languages": ["Hindi"]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Acme Sales Agent",
    "language": "English",
    "agent_type": "sales",
    "description": null,
    "custom_description": null,
    "sector": "Finance & Banking",
    "tone": "professional",
    "agent_role": null,
    "ai_model": "lai-premium-2",
    "voice": "female",
    "voice_id": null,
    "accent": null,
    "pronunciations": null,
    "voice_response_settings": {
      "listening_sensitivity": 0.5,
      "wait_before_responding": 200,
      "silence_to_end_turn": 300,
      "allow_user_to_interrupt": true,
      "words_to_interrupt": 2,
      "min_response_wait": 0.15,
      "max_response_wait": 0.3,
      "fast_response": true,
      "voice_detection_sensitivity": 0.5,
      "quick_response_padding": 200,
      "turn_end_silence": 300,
      "vad_type": "server_vad",
      "eagerness": "medium",
      "remind_on_silence": true,
      "silence_before_reminder": 10,
      "max_reminders": 3,
      "custom_reminder_messages": null,
      "detect_ivr_systems": true,
      "enable_dtmf_input": false,
      "leave_voicemail": false,
      "max_call_duration_minutes": 15,
      "greeting_delay": 0,
      "call_analysis_enabled": true,
      "immediate_transfer": false,
      "response_creativity": 0.8,
      "turn_detection": "vad"
    },
    "prompt": "You are an AI sales agent for Acme Finance. Greet the customer warmly, qualify their interest in personal loans, and collect their details for follow-up.",
    "start_flow": "Hello! I'm calling from Acme Finance. Am I speaking with the right person?",
    "end_flow": "Thank you for your time! Have a great day.",
    "details_to_collect": [
      {
        "key": "full_name",
        "type": "text",
        "description": "Customer's full name"
      },
      {
        "key": "monthly_income",
        "type": "number",
        "description": "Monthly income in INR"
      },
      {
        "key": "email",
        "type": "email",
        "description": "Email address for follow-up"
      }
    ],
    "brand_name": "Acme Finance",
    "typed_knowledge": "Personal loan products from 50,000 to 25,00,000 INR. Interest rates starting at 10.5% p.a.",
    "timezone": "Asia/Kolkata",
    "other_languages": [
      "Hindi"
    ],
    "webhook_config": {
      "url": "https://api.yourcompany.com/webhooks/levrage",
      "events": [
        "call.completed",
        "call.failed"
      ]
    },
    "custom_api": [],
    "lookup_api": {
      "enabled": true,
      "api_name": "Customer CRM Lookup",
      "api_url": "https://api.yourcompany.com/customers",
      "method": "GET",
      "query_params": [
        {
          "key": "phone",
          "value": "{number}",
          "is_variable": true
        }
      ],
      "headers": [
        {
          "key": "Authorization",
          "value": "Bearer your_crm_api_key",
          "is_variable": false
        }
      ],
      "timeout_seconds": 10,
      "retry_count": 1
    },
    "transfer_map": [
      {
        "name": "Sales Manager",
        "number": "9876543210",
        "country_code": "+91",
        "category": "escalation"
      }
    ],
    "is_active": true,
    "created_at": "2026-01-15T09:30:00+05:30",
    "updated_at": "2026-01-15T09:30:00+05:30"
  },
  "request_id": "req_a1b2c3d4e5f6",
  "timestamp": "2026-01-15T09:30:00+05:30",
  "success": true
}

Create a new voice agent.

Required fields: name, agent_type, sector (industry), ai_model. If prompt is not provided, it will be auto-generated from the agent config.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

namestringRequired1-100 characters

Agent name

agent_typestringRequired>=1 character

Agent type: sales, support, custom

sectorstringRequired>=1 character

Industry sector (e.g. Real Estate, Finance & Banking, Healthcare, E-commerce & Retail)

ai_modelstringRequired>=1 character

AI model: lai-premium-2, lai-premium-3, lai-premium-4

languagestringOptional>=1 characterDefaults to English

Agent language: English, Hindi, Tamil, Telugu, Bengali, Gujarati, Kannada, Malayalam, Marathi

descriptionstring or nullOptional>=1 character

Agent description

custom_descriptionstring or nullOptional>=1 character

Custom agent description (required if agent_type=custom)

start_flowstring or nullOptional>=1 character

Opening greeting message. Auto-generated if not provided.

end_flowstring or nullOptional>=1 character

Closing message. Auto-generated if not provided.

tonestring or nullOptional>=1 characterDefaults to professional

Agent tone: professional, friendly, casual, formal

agent_rolestring or nullOptional>=1 character

Agent role title

voicestring or nullOptional>=1 character

Voice gender: male or female

voice_idstring or nullOptional>=1 character

Specific voice ID for TTS

accentstring or nullOptional>=1 character

Voice accent

pronunciationsmap from strings to strings or nullOptional

Custom pronunciation rules {word: pronunciation}

voice_response_settingsobject or nullOptional

Voice & response settings

background_sounds_enabledboolean or nullOptional

Office background sound during calls

promptstring or nullOptional>=1 character

Custom agent prompt/instructions. Auto-generated if not provided.

details_to_collectlist of any or nullOptional

Details to collect during call

brand_namestring or nullOptional>=1 character

Company/brand name

typed_knowledgestring or nullOptional>=1 character

Knowledge base text

timezonestring or nullOptional>=1 character

Agent timezone (e.g. Asia/Kolkata)

knowledge_base_idslist of strings or nullOptional

Knowledge bases the agent searches during calls (ids from /v1/knowledge-bases)

webhook_configobject or nullOptional

Webhook configuration

custom_apilist of objects or nullOptional

Custom API tool configs

lookup_apiobject or nullOptional

Pre-call data lookup config

transfer_maplist of objects or nullOptional

Human handoff phone numbers

other_languageslist of strings or nullOptional

Additional languages (e.g. [‘Hindi’, ‘Spanish’])

Response

Successful Response

dataobject

Full agent detail response.

request_idstring

timestampdatetime

successbooleanOptionalDefaults to true

Errors

422

Unprocessable Entity Error