Skip to main content
POST
/
batch-call
Create batch call
curl --request POST \
  --url https://api.zudu.ai/batch-call \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --header 'X-API-SECRET: <api-key>' \
  --data '
{
  "from_number": "+918035315547",
  "name": "new_batch_call_docs",
  "agent_id": "agent_90412a2c-fb63-418f-af25-8ecc1bdcc16e",
  "retry_config": {
    "enabled": true,
    "max_attempts": 3
  },
  "quiet_hours": {
    "enabled": true,
    "start_time": "22:00",
    "end_time": "08:00",
    "timezone": "Asia/Calcutta"
  },
  "retry_rules": [
    {
      "condition": "no_answer",
      "enabled": true,
      "retry_timing": {
        "type": "AT",
        "time": "13:00"
      }
    },
    {
      "condition": "busy",
      "enabled": true,
      "retry_timing": {
        "type": "AT",
        "time": "14:00"
      }
    },
    {
      "condition": "voicemail",
      "enabled": true,
      "retry_timing": {
        "type": "AFTER",
        "duration_minutes": 120
      }
    }
  ],
  "send_now": false,
  "tasks": [
    {
      "to_number": "+919600011957",
      "dynamic_variables": {
        "order_id": "5001201",
        "name": "Aswathi",
        "gender": "Female",
        "address": "Green Park Residency",
        "branchname": "WHITEFIELD-HUB",
        "cityname": "Bangalore",
        "created_date": "1/5/26",
        "scheduleddate": "1/10/26"
      }
    },
    {
      "to_number": "+919445216009",
      "dynamic_variables": {
        "order_id": "5001202",
        "name": "dev",
        "gender": "Female",
        "address": "Lake View Apartments",
        "branchname": "MADHAPUR-HUB",
        "cityname": "Hyderabad",
        "created_date": "1/6/26",
        "scheduleddate": "1/12/26"
      }
    }
  ],
  "timezone": "Asia/Calcutta",
  "trigger_timestamp": 1771573740000
}
'
{
  "batch_call_id": "batch_call_73077b8359a4478189e503a1547a9147",
  "name": "new_batch_call_docs",
  "from_number": "+918035315547",
  "scheduled_timestamp": 1771573740000,
  "total_task_count": 2,
  "agent_id": "agent_90412a2c-fb63-418f-af25-8ecc1bdcc16e",
  "organization_id": "org_32x5WvKzp28883DHaKC1YgEHzdE",
  "status": "scheduled",
  "error": null,
  "total": 2,
  "sent": 0,
  "picked_up": 0,
  "completed": 0,
  "timezone": "Asia/Calcutta",
  "last_sent_timestamp": null,
  "tasks_url": "https://stzuduindiav845035245154.blob.core.windows.net/5ffbe4b2-c66e-4fce-bf5f-38e755a92d87-azureml/batch-calls/batch_call_73077b8359a4478189e503a1547a9147/tasks.json",
  "created_timestamp": 1770882512648,
  "access_info": {
    "creator_image_url": "https://img.clerk.com/eyJ0eXBlIjoiZGVmYXVsdCIsImlpZCI6Imluc18yeVBYYWt0S0d3VWkyN3d5R0haSHE5TVVCMlYiLCJyaWQiOiJ1c2VyXzM4TjNvRzVpT1ZlZW0yWmxwT0pTT0N6dEhKayIsImluaXRpYWxzIjoiQVYifQ",
    "creator_name": "Aswathi VK"
  },
  "is_paused": false,
  "paused_at": null
}

Notes

  • Option 1 (Send now): set send_now=true.
  • Option 2 (Schedule call later): provide trigger_timestamp (send_now can be false or omitted).
  • status="draft" overrides execution.

Authorizations

X-API-KEY
string
header
required

API Key for MCP server and external service authentication

X-API-SECRET
string
header
required

API Secret for MCP server and external service authentication

Body

application/json
from_number
string
required

E.164 format

tasks
object[]
required
Required array length: 1 - 1000 elements
name
string
required
Maximum string length: 255
agent_id
string
required

agent_[uuid] format

send_now
boolean
default:false
required

Set true to send immediately. Use false/omit when scheduling with trigger_timestamp.

trigger_timestamp
integer<int64>

Unix timestamp (milliseconds). Required when scheduling (send_now false or omitted).

retry_config
object
quiet_hours
object
retry_rules
object[]
timezone
string

Valid timezone, default UTC

status
enum<string>
Available options:
draft,
scheduled,
sent
organization_id
string

Response

Batch call created successfully

batch_call_id
string
name
string
from_number
string
scheduled_timestamp
integer<int64>
total_task_count
integer
agent_id
string
organization_id
string
status
string
error
string | null
total
integer
sent
integer
picked_up
integer
completed
integer
timezone
string
last_sent_timestamp
integer<int64> | null
tasks_url
string
created_timestamp
integer<int64>
access_info
object
is_paused
boolean
paused_at
integer<int64> | null