Create Agent

POST

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

POST

/v1/agents

1 import requests
2 
3 url = "https://api.levrage.ai/v1/agents"
4 
5 payload = {
6     "name": "Acme Sales Agent",
7     "agent_type": "sales",
8     "sector": "Finance & Banking",
9     "ai_model": "lai-premium-2",
10     "start_flow": "Hello! I'm calling from Acme Finance. Am I speaking with the right person?",
11     "end_flow": "Thank you for your time! Have a great day.",
12     "language": "English",
13     "tone": "professional",
14     "voice": "female",
15     "voice_response_settings": {
16         "allow_user_to_interrupt": True,
17         "words_to_interrupt": 2,
18         "fast_response": True,
19         "remind_on_silence": True,
20         "silence_before_reminder": 10,
21         "max_reminders": 3,
22         "max_call_duration_minutes": 15,
23         "response_creativity": 0.8
24     },
25     "details_to_collect": [
26         {
27             "key": "full_name",
28             "type": "text",
29             "description": "Customer's full name"
30         },
31         {
32             "key": "monthly_income",
33             "type": "number",
34             "description": "Monthly income in INR"
35         },
36         {
37             "key": "email",
38             "type": "email",
39             "description": "Email address for follow-up"
40         }
41     ],
42     "brand_name": "Acme Finance",
43     "typed_knowledge": "Personal loan products from 50,000 to 25,00,000 INR. Interest rates starting at 10.5% p.a.",
44     "timezone": "Asia/Kolkata",
45     "webhook_config": {
46         "url": "https://api.yourcompany.com/webhooks/levrage",
47         "events": ["call.completed", "call.failed"]
48     },
49     "lookup_api": {
50         "enabled": True,
51         "api_name": "Customer CRM Lookup",
52         "api_url": "https://api.yourcompany.com/customers",
53         "method": "GET",
54         "query_params": [
55             {
56                 "key": "phone",
57                 "value": "{number}",
58                 "is_variable": True
59             }
60         ],
61         "headers": [
62             {
63                 "key": "Authorization",
64                 "value": "Bearer your_crm_api_key",
65                 "is_variable": False
66             }
67         ],
68         "timeout_seconds": 10,
69         "retry_count": 1
70     },
71     "transfer_map": [
72         {
73             "name": "Sales Manager",
74             "number": "9876543210",
75             "country_code": "+91",
76             "category": "escalation"
77         }
78     ],
79     "other_languages": ["Hindi"]
80 }
81 headers = {
82     "Authorization": "Bearer <token>",
83     "Content-Type": "application/json"
84 }
85 
86 response = requests.post(url, json=payload, headers=headers)
87 
88 print(response.json())

1 {
2   "data": {
3     "id": "550e8400-e29b-41d4-a716-446655440000",
4     "name": "Acme Sales Agent",
5     "language": "English",
6     "agent_type": "sales",
7     "sector": "Finance & Banking",
8     "tone": "professional",
9     "ai_model": "lai-premium-2",
10     "voice": "female",
11     "voice_response_settings": {
12       "listening_sensitivity": 0.5,
13       "wait_before_responding": 200,
14       "silence_to_end_turn": 300,
15       "allow_user_to_interrupt": true,
16       "words_to_interrupt": 2,
17       "min_response_wait": 0.15,
18       "max_response_wait": 0.3,
19       "fast_response": true,
20       "voice_detection_sensitivity": 0.5,
21       "quick_response_padding": 200,
22       "turn_end_silence": 300,
23       "vad_type": "server_vad",
24       "eagerness": "medium",
25       "remind_on_silence": true,
26       "silence_before_reminder": 10,
27       "max_reminders": 3,
28       "detect_ivr_systems": true,
29       "enable_dtmf_input": false,
30       "leave_voicemail": false,
31       "max_call_duration_minutes": 15,
32       "greeting_delay": 0,
33       "call_analysis_enabled": true,
34       "immediate_transfer": false,
35       "response_creativity": 0.8,
36       "turn_detection": "vad"
37     },
38     "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.",
39     "start_flow": "Hello! I'm calling from Acme Finance. Am I speaking with the right person?",
40     "end_flow": "Thank you for your time! Have a great day.",
41     "details_to_collect": [
42       {
43         "key": "full_name",
44         "type": "text",
45         "description": "Customer's full name"
46       },
47       {
48         "key": "monthly_income",
49         "type": "number",
50         "description": "Monthly income in INR"
51       },
52       {
53         "key": "email",
54         "type": "email",
55         "description": "Email address for follow-up"
56       }
57     ],
58     "brand_name": "Acme Finance",
59     "typed_knowledge": "Personal loan products from 50,000 to 25,00,000 INR. Interest rates starting at 10.5% p.a.",
60     "timezone": "Asia/Kolkata",
61     "other_languages": [
62       "Hindi"
63     ],
64     "webhook_config": {
65       "url": "https://api.yourcompany.com/webhooks/levrage",
66       "events": [
67         "call.completed",
68         "call.failed"
69       ]
70     },
71     "custom_api": [],
72     "lookup_api": {
73       "enabled": true,
74       "api_name": "Customer CRM Lookup",
75       "api_url": "https://api.yourcompany.com/customers",
76       "method": "GET",
77       "query_params": [
78         {
79           "key": "phone",
80           "value": "{number}",
81           "is_variable": true
82         }
83       ],
84       "headers": [
85         {
86           "key": "Authorization",
87           "value": "Bearer your_crm_api_key",
88           "is_variable": false
89         }
90       ],
91       "timeout_seconds": 10,
92       "retry_count": 1
93     },
94     "transfer_map": [
95       {
96         "name": "Sales Manager",
97         "number": "9876543210",
98         "country_code": "+91",
99         "category": "escalation"
100       }
101     ],
102     "is_active": true,
103     "created_at": "2026-01-15T09:30:00+05:30",
104     "updated_at": "2026-01-15T09:30:00+05:30"
105   },
106   "request_id": "req_a1b2c3d4e5f6",
107   "timestamp": "2026-01-15T09:30:00+05:30",
108   "success": true
109 }

Create a new voice agent.

Required fields: name, start_flow, end_flow. Default AI model: lai-premium-2. 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

Agent type: sales, support, custom

sectorstringRequired

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

ai_modelstringRequired

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

start_flowstring or nullOptional

Opening greeting message. Auto-generated if not provided.

end_flowstring or nullOptional

Closing message. Auto-generated if not provided.

descriptionstring or nullOptional

Agent description

custom_descriptionstring or nullOptional

Custom agent description (required if agent_type=custom)

languagestringOptionalDefaults to English

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

tonestring or nullOptional

Agent tone: professional, friendly, casual, formal

agent_rolestring or nullOptional

Agent role title

voicestring or nullOptional

Voice gender: male or female

voice_idstring or nullOptional

Specific voice ID for TTS

accentstring or nullOptional

Voice accent

pronunciationsmap from strings to strings or nullOptional

Custom pronunciation rules {word: pronunciation}

voice_response_settingsobject or nullOptional

Voice & response settings

promptstring or nullOptional

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

details_to_collectlist of objects or nullOptional

Information the agent should collect during the call. List of items, each with: key (string — field name), type (text/number/email/phone), description (string — what to collect)

brand_namestring or nullOptional

Company/brand name

typed_knowledgestring or nullOptional

Knowledge base text

timezonestring or nullOptional

Agent timezone (e.g. Asia/Kolkata)

webhook_configobject or nullOptional

Webhook configuration. Fields: url (string, required) — the endpoint URL to receive events. Optional: events (list of event names like call.completed, call.failed), headers (dict of custom headers)

custom_apilist of objects or nullOptional

List of custom API tool configurations the agent can call during conversations. Each item: api_name (string), api_url (string), method (GET/POST/PUT/DELETE), headers (list of {key, value}), query_params (list of {key, value, is_variable}), body (dict/string), content_type (application/json)

lookup_apiobject or nullOptional

Pre-call data lookup configuration. Called at session start to fetch customer data. Required fields: api_name (string), api_url (string), method (GET/POST). Optional: enabled (bool), headers (list of {key, value, is_variable}), query_params (list of {key, value, is_variable}), path_params (list of {name, source}), body_template (dict), auth_type (bearer/api_key/basic), auth_token (string), timeout_seconds (int), retry_count (int)

transfer_maplist of objects or nullOptional

Human handoff phone numbers. List of transfer targets, each with: name (string), number (string — phone number), country_code (string), category (string)

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