Make a Call | Levrage.AI | API Documentation

import requests
url = "https://api.levrage.ai/v1/call"
payload = {
    "agent_id": "550e8400-e29b-41d4-a716-446655440000",
    "source_number": "+919240018601",
    "phone_number": "+919876543210",
    "metadata": {
        "customer_name": "Rahul Sharma",
        "order_id": "ORD-12345"
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "data": {
    "id": "a3f1c9e2-7b4d-4f8a-9c2e-1d2f3b4a5c6d",
    "status": "initializing",
    "phone_number": "+919876543210",
    "agent": {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Acme Sales Agent"
    },
    "user_id": "user_a1b2c3d4",
    "created_at": "2026-01-15T09:30:00+05:30",
    "metadata": {
      "customer_name": "Rahul Sharma",
      "order_id": "ORD-12345"
    }
  },
  "request_id": "req_a1b2c3d4e5f6",
  "timestamp": "2026-01-15T09:30:00+05:30",
  "success": true
}

Initiate an outbound call to the specified phone number. The call will use the specified voice agent and any metadata provided will be available to the agent during the conversation.

Authentication

AuthorizationBearer

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

Request

This endpoint expects an object.

agent_idstringRequired

Voice agent UUID

source_numberstringRequired

Source phone number to call from (+91…)

phone_numberstringRequired

Phone to call (+91…)

metadataobject or nullOptional

Custom data for agent

Response

Successful Response

dataobject

Call data inside response envelope.

request_idstring

timestampdatetime

successbooleanDefaults to true

Errors

422

Unprocessable Entity Error

1	import requests
2
3	url = "https://api.levrage.ai/v1/call"
4
5	payload = {
6	"agent_id": "550e8400-e29b-41d4-a716-446655440000",
7	"source_number": "+919240018601",
8	"phone_number": "+919876543210",
9	"metadata": {
10	"customer_name": "Rahul Sharma",
11	"order_id": "ORD-12345"
12	}
13	}
14	headers = {
15	"Authorization": "Bearer <token>",
16	"Content-Type": "application/json"
17	}
18
19	response = requests.post(url, json=payload, headers=headers)
20
21	print(response.json())

1	{
2	"data": {
3	"id": "a3f1c9e2-7b4d-4f8a-9c2e-1d2f3b4a5c6d",
4	"status": "initializing",
5	"phone_number": "+919876543210",
6	"agent": {
7	"id": "550e8400-e29b-41d4-a716-446655440000",
8	"name": "Acme Sales Agent"
9	},
10	"user_id": "user_a1b2c3d4",
11	"created_at": "2026-01-15T09:30:00+05:30",
12	"metadata": {
13	"customer_name": "Rahul Sharma",
14	"order_id": "ORD-12345"
15	}
16	},
17	"request_id": "req_a1b2c3d4e5f6",
18	"timestamp": "2026-01-15T09:30:00+05:30",
19	"success": true
20	}