Make a call

POST

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

POST

/v1/call

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>=1 character

Voice agent UUID

source_numberstringRequired>=1 character

Source phone number to call from (+91…)

phone_numberstringRequired>=1 character

Phone to call (+91…)

metadataobject or nullOptional

Custom data for agent

Response

Successful Response

dataobject

Call data inside response envelope.

request_idstring

timestampdatetime

successbooleanOptionalDefaults to true

Errors

422

Unprocessable Entity Error