Create Campaign | Levrage.AI | API Documentation

import requests
url = "https://api.levrage.ai/v1/campaigns"
payload = {
    "name": "January Sales Outreach",
    "agent_id": "550e8400-e29b-41d4-a716-446655440000",
    "phone_number": "+919240018601",
    "contacts": [
        {
            "phone": "+919876543210",
            "name": "Rahul Sharma",
            "company": "TechCo"
        },
        {
            "phone": "+919876543211",
            "name": "Priya Patel",
            "company": "FinCo"
        }
    ],
    "phone_column": "phone",
    "max_concurrent_calls": 3
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "data": {
    "id": "c9f0c9e2-4d3a-4b7a-9f1e-2a3b4c5d6e7f",
    "name": "January Sales Outreach",
    "status": "pending",
    "total_contacts": 2,
    "valid_contacts": 2,
    "skipped_contacts": 0,
    "completed": 0,
    "failed": 0,
    "no_answer": 0,
    "voicemail": 0,
    "retry_enabled": false,
    "pending_retries": 0,
    "max_concurrent_calls": 3,
    "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 campaign to call multiple contacts. Supports scheduling, retry configuration, and blackout periods.

Authentication

AuthorizationBearer

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

Request

This endpoint expects an object.

namestringRequired<=100 characters

Campaign name

agent_idstringRequired

Voice agent UUID

phone_numberstringRequired

Source phone number

contactslist of objectsRequired

Contacts array (max 2000)

phone_columnstringOptionalDefaults to phone

Field containing phone numbers

max_concurrent_callsintegerOptional1-50Defaults to 1

Parallel calls (1-50)

schedule_timedatetime or nullOptional

Schedule for future (ISO 8601)

timezonestring or nullOptional

Timezone e.g. ‘Asia/Kolkata’

start_timedatetime or nullOptional

Campaign start time

end_timedatetime or nullOptional

Campaign end time

daily_start_timestring or nullOptional

Daily calling start HH:MM

daily_end_timestring or nullOptional

Daily calling end HH:MM

retry_configobject or nullOptional

Retry settings for failed calls

blackout_periodslist of objects or nullOptional

No-call time windows

Response

Successful Response

dataobject

Campaign data inside response envelope.

request_idstring

timestampdatetime

successbooleanOptionalDefaults to true

Errors

422

Unprocessable Entity Error