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
}
'import requests
url = "https://api.zudu.ai/batch-call"
payload = {
"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
}
headers = {
"X-API-KEY": "<api-key>",
"X-API-SECRET": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'X-API-KEY': '<api-key>',
'X-API-SECRET': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
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
})
};
fetch('https://api.zudu.ai/batch-call', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.zudu.ai/batch-call",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'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
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-KEY: <api-key>",
"X-API-SECRET: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.zudu.ai/batch-call"
payload := strings.NewReader("{\n \"from_number\": \"+918035315547\",\n \"name\": \"new_batch_call_docs\",\n \"agent_id\": \"agent_90412a2c-fb63-418f-af25-8ecc1bdcc16e\",\n \"retry_config\": {\n \"enabled\": true,\n \"max_attempts\": 3\n },\n \"quiet_hours\": {\n \"enabled\": true,\n \"start_time\": \"22:00\",\n \"end_time\": \"08:00\",\n \"timezone\": \"Asia/Calcutta\"\n },\n \"retry_rules\": [\n {\n \"condition\": \"no_answer\",\n \"enabled\": true,\n \"retry_timing\": {\n \"type\": \"AT\",\n \"time\": \"13:00\"\n }\n },\n {\n \"condition\": \"busy\",\n \"enabled\": true,\n \"retry_timing\": {\n \"type\": \"AT\",\n \"time\": \"14:00\"\n }\n },\n {\n \"condition\": \"voicemail\",\n \"enabled\": true,\n \"retry_timing\": {\n \"type\": \"AFTER\",\n \"duration_minutes\": 120\n }\n }\n ],\n \"send_now\": false,\n \"tasks\": [\n {\n \"to_number\": \"+919600011957\",\n \"dynamic_variables\": {\n \"order_id\": \"5001201\",\n \"name\": \"Aswathi\",\n \"gender\": \"Female\",\n \"address\": \"Green Park Residency\",\n \"branchname\": \"WHITEFIELD-HUB\",\n \"cityname\": \"Bangalore\",\n \"created_date\": \"1/5/26\",\n \"scheduleddate\": \"1/10/26\"\n }\n },\n {\n \"to_number\": \"+919445216009\",\n \"dynamic_variables\": {\n \"order_id\": \"5001202\",\n \"name\": \"dev\",\n \"gender\": \"Female\",\n \"address\": \"Lake View Apartments\",\n \"branchname\": \"MADHAPUR-HUB\",\n \"cityname\": \"Hyderabad\",\n \"created_date\": \"1/6/26\",\n \"scheduleddate\": \"1/12/26\"\n }\n }\n ],\n \"timezone\": \"Asia/Calcutta\",\n \"trigger_timestamp\": 1771573740000\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-KEY", "<api-key>")
req.Header.Add("X-API-SECRET", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.zudu.ai/batch-call")
.header("X-API-KEY", "<api-key>")
.header("X-API-SECRET", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"from_number\": \"+918035315547\",\n \"name\": \"new_batch_call_docs\",\n \"agent_id\": \"agent_90412a2c-fb63-418f-af25-8ecc1bdcc16e\",\n \"retry_config\": {\n \"enabled\": true,\n \"max_attempts\": 3\n },\n \"quiet_hours\": {\n \"enabled\": true,\n \"start_time\": \"22:00\",\n \"end_time\": \"08:00\",\n \"timezone\": \"Asia/Calcutta\"\n },\n \"retry_rules\": [\n {\n \"condition\": \"no_answer\",\n \"enabled\": true,\n \"retry_timing\": {\n \"type\": \"AT\",\n \"time\": \"13:00\"\n }\n },\n {\n \"condition\": \"busy\",\n \"enabled\": true,\n \"retry_timing\": {\n \"type\": \"AT\",\n \"time\": \"14:00\"\n }\n },\n {\n \"condition\": \"voicemail\",\n \"enabled\": true,\n \"retry_timing\": {\n \"type\": \"AFTER\",\n \"duration_minutes\": 120\n }\n }\n ],\n \"send_now\": false,\n \"tasks\": [\n {\n \"to_number\": \"+919600011957\",\n \"dynamic_variables\": {\n \"order_id\": \"5001201\",\n \"name\": \"Aswathi\",\n \"gender\": \"Female\",\n \"address\": \"Green Park Residency\",\n \"branchname\": \"WHITEFIELD-HUB\",\n \"cityname\": \"Bangalore\",\n \"created_date\": \"1/5/26\",\n \"scheduleddate\": \"1/10/26\"\n }\n },\n {\n \"to_number\": \"+919445216009\",\n \"dynamic_variables\": {\n \"order_id\": \"5001202\",\n \"name\": \"dev\",\n \"gender\": \"Female\",\n \"address\": \"Lake View Apartments\",\n \"branchname\": \"MADHAPUR-HUB\",\n \"cityname\": \"Hyderabad\",\n \"created_date\": \"1/6/26\",\n \"scheduleddate\": \"1/12/26\"\n }\n }\n ],\n \"timezone\": \"Asia/Calcutta\",\n \"trigger_timestamp\": 1771573740000\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.zudu.ai/batch-call")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["X-API-SECRET"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"from_number\": \"+918035315547\",\n \"name\": \"new_batch_call_docs\",\n \"agent_id\": \"agent_90412a2c-fb63-418f-af25-8ecc1bdcc16e\",\n \"retry_config\": {\n \"enabled\": true,\n \"max_attempts\": 3\n },\n \"quiet_hours\": {\n \"enabled\": true,\n \"start_time\": \"22:00\",\n \"end_time\": \"08:00\",\n \"timezone\": \"Asia/Calcutta\"\n },\n \"retry_rules\": [\n {\n \"condition\": \"no_answer\",\n \"enabled\": true,\n \"retry_timing\": {\n \"type\": \"AT\",\n \"time\": \"13:00\"\n }\n },\n {\n \"condition\": \"busy\",\n \"enabled\": true,\n \"retry_timing\": {\n \"type\": \"AT\",\n \"time\": \"14:00\"\n }\n },\n {\n \"condition\": \"voicemail\",\n \"enabled\": true,\n \"retry_timing\": {\n \"type\": \"AFTER\",\n \"duration_minutes\": 120\n }\n }\n ],\n \"send_now\": false,\n \"tasks\": [\n {\n \"to_number\": \"+919600011957\",\n \"dynamic_variables\": {\n \"order_id\": \"5001201\",\n \"name\": \"Aswathi\",\n \"gender\": \"Female\",\n \"address\": \"Green Park Residency\",\n \"branchname\": \"WHITEFIELD-HUB\",\n \"cityname\": \"Bangalore\",\n \"created_date\": \"1/5/26\",\n \"scheduleddate\": \"1/10/26\"\n }\n },\n {\n \"to_number\": \"+919445216009\",\n \"dynamic_variables\": {\n \"order_id\": \"5001202\",\n \"name\": \"dev\",\n \"gender\": \"Female\",\n \"address\": \"Lake View Apartments\",\n \"branchname\": \"MADHAPUR-HUB\",\n \"cityname\": \"Hyderabad\",\n \"created_date\": \"1/6/26\",\n \"scheduleddate\": \"1/12/26\"\n }\n }\n ],\n \"timezone\": \"Asia/Calcutta\",\n \"trigger_timestamp\": 1771573740000\n}"
response = http.request(request)
puts response.read_body{
"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
}{
"message": "Validation error",
"status": "error",
"error": "Duplicate phone numbers found in tasks. Each phone number must be unique within a batch call",
"data": null
}{
"message": "Missing required header",
"status": "error",
"error": "orgId header is required for this operation",
"data": null
}{
"message": "Access denied",
"status": "error",
"error": "Batch call does not belong to your organization",
"data": null
}{
"message": "Cannot update batch call",
"status": "error",
"error": "Cannot update running batch call",
"data": null
}Batch Calls
Create batch call
Creates a new batch call.
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
}
'import requests
url = "https://api.zudu.ai/batch-call"
payload = {
"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
}
headers = {
"X-API-KEY": "<api-key>",
"X-API-SECRET": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'X-API-KEY': '<api-key>',
'X-API-SECRET': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
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
})
};
fetch('https://api.zudu.ai/batch-call', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.zudu.ai/batch-call",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'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
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-KEY: <api-key>",
"X-API-SECRET: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.zudu.ai/batch-call"
payload := strings.NewReader("{\n \"from_number\": \"+918035315547\",\n \"name\": \"new_batch_call_docs\",\n \"agent_id\": \"agent_90412a2c-fb63-418f-af25-8ecc1bdcc16e\",\n \"retry_config\": {\n \"enabled\": true,\n \"max_attempts\": 3\n },\n \"quiet_hours\": {\n \"enabled\": true,\n \"start_time\": \"22:00\",\n \"end_time\": \"08:00\",\n \"timezone\": \"Asia/Calcutta\"\n },\n \"retry_rules\": [\n {\n \"condition\": \"no_answer\",\n \"enabled\": true,\n \"retry_timing\": {\n \"type\": \"AT\",\n \"time\": \"13:00\"\n }\n },\n {\n \"condition\": \"busy\",\n \"enabled\": true,\n \"retry_timing\": {\n \"type\": \"AT\",\n \"time\": \"14:00\"\n }\n },\n {\n \"condition\": \"voicemail\",\n \"enabled\": true,\n \"retry_timing\": {\n \"type\": \"AFTER\",\n \"duration_minutes\": 120\n }\n }\n ],\n \"send_now\": false,\n \"tasks\": [\n {\n \"to_number\": \"+919600011957\",\n \"dynamic_variables\": {\n \"order_id\": \"5001201\",\n \"name\": \"Aswathi\",\n \"gender\": \"Female\",\n \"address\": \"Green Park Residency\",\n \"branchname\": \"WHITEFIELD-HUB\",\n \"cityname\": \"Bangalore\",\n \"created_date\": \"1/5/26\",\n \"scheduleddate\": \"1/10/26\"\n }\n },\n {\n \"to_number\": \"+919445216009\",\n \"dynamic_variables\": {\n \"order_id\": \"5001202\",\n \"name\": \"dev\",\n \"gender\": \"Female\",\n \"address\": \"Lake View Apartments\",\n \"branchname\": \"MADHAPUR-HUB\",\n \"cityname\": \"Hyderabad\",\n \"created_date\": \"1/6/26\",\n \"scheduleddate\": \"1/12/26\"\n }\n }\n ],\n \"timezone\": \"Asia/Calcutta\",\n \"trigger_timestamp\": 1771573740000\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-KEY", "<api-key>")
req.Header.Add("X-API-SECRET", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.zudu.ai/batch-call")
.header("X-API-KEY", "<api-key>")
.header("X-API-SECRET", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"from_number\": \"+918035315547\",\n \"name\": \"new_batch_call_docs\",\n \"agent_id\": \"agent_90412a2c-fb63-418f-af25-8ecc1bdcc16e\",\n \"retry_config\": {\n \"enabled\": true,\n \"max_attempts\": 3\n },\n \"quiet_hours\": {\n \"enabled\": true,\n \"start_time\": \"22:00\",\n \"end_time\": \"08:00\",\n \"timezone\": \"Asia/Calcutta\"\n },\n \"retry_rules\": [\n {\n \"condition\": \"no_answer\",\n \"enabled\": true,\n \"retry_timing\": {\n \"type\": \"AT\",\n \"time\": \"13:00\"\n }\n },\n {\n \"condition\": \"busy\",\n \"enabled\": true,\n \"retry_timing\": {\n \"type\": \"AT\",\n \"time\": \"14:00\"\n }\n },\n {\n \"condition\": \"voicemail\",\n \"enabled\": true,\n \"retry_timing\": {\n \"type\": \"AFTER\",\n \"duration_minutes\": 120\n }\n }\n ],\n \"send_now\": false,\n \"tasks\": [\n {\n \"to_number\": \"+919600011957\",\n \"dynamic_variables\": {\n \"order_id\": \"5001201\",\n \"name\": \"Aswathi\",\n \"gender\": \"Female\",\n \"address\": \"Green Park Residency\",\n \"branchname\": \"WHITEFIELD-HUB\",\n \"cityname\": \"Bangalore\",\n \"created_date\": \"1/5/26\",\n \"scheduleddate\": \"1/10/26\"\n }\n },\n {\n \"to_number\": \"+919445216009\",\n \"dynamic_variables\": {\n \"order_id\": \"5001202\",\n \"name\": \"dev\",\n \"gender\": \"Female\",\n \"address\": \"Lake View Apartments\",\n \"branchname\": \"MADHAPUR-HUB\",\n \"cityname\": \"Hyderabad\",\n \"created_date\": \"1/6/26\",\n \"scheduleddate\": \"1/12/26\"\n }\n }\n ],\n \"timezone\": \"Asia/Calcutta\",\n \"trigger_timestamp\": 1771573740000\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.zudu.ai/batch-call")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["X-API-SECRET"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"from_number\": \"+918035315547\",\n \"name\": \"new_batch_call_docs\",\n \"agent_id\": \"agent_90412a2c-fb63-418f-af25-8ecc1bdcc16e\",\n \"retry_config\": {\n \"enabled\": true,\n \"max_attempts\": 3\n },\n \"quiet_hours\": {\n \"enabled\": true,\n \"start_time\": \"22:00\",\n \"end_time\": \"08:00\",\n \"timezone\": \"Asia/Calcutta\"\n },\n \"retry_rules\": [\n {\n \"condition\": \"no_answer\",\n \"enabled\": true,\n \"retry_timing\": {\n \"type\": \"AT\",\n \"time\": \"13:00\"\n }\n },\n {\n \"condition\": \"busy\",\n \"enabled\": true,\n \"retry_timing\": {\n \"type\": \"AT\",\n \"time\": \"14:00\"\n }\n },\n {\n \"condition\": \"voicemail\",\n \"enabled\": true,\n \"retry_timing\": {\n \"type\": \"AFTER\",\n \"duration_minutes\": 120\n }\n }\n ],\n \"send_now\": false,\n \"tasks\": [\n {\n \"to_number\": \"+919600011957\",\n \"dynamic_variables\": {\n \"order_id\": \"5001201\",\n \"name\": \"Aswathi\",\n \"gender\": \"Female\",\n \"address\": \"Green Park Residency\",\n \"branchname\": \"WHITEFIELD-HUB\",\n \"cityname\": \"Bangalore\",\n \"created_date\": \"1/5/26\",\n \"scheduleddate\": \"1/10/26\"\n }\n },\n {\n \"to_number\": \"+919445216009\",\n \"dynamic_variables\": {\n \"order_id\": \"5001202\",\n \"name\": \"dev\",\n \"gender\": \"Female\",\n \"address\": \"Lake View Apartments\",\n \"branchname\": \"MADHAPUR-HUB\",\n \"cityname\": \"Hyderabad\",\n \"created_date\": \"1/6/26\",\n \"scheduleddate\": \"1/12/26\"\n }\n }\n ],\n \"timezone\": \"Asia/Calcutta\",\n \"trigger_timestamp\": 1771573740000\n}"
response = http.request(request)
puts response.read_body{
"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
}{
"message": "Validation error",
"status": "error",
"error": "Duplicate phone numbers found in tasks. Each phone number must be unique within a batch call",
"data": null
}{
"message": "Missing required header",
"status": "error",
"error": "orgId header is required for this operation",
"data": null
}{
"message": "Access denied",
"status": "error",
"error": "Batch call does not belong to your organization",
"data": null
}{
"message": "Cannot update batch call",
"status": "error",
"error": "Cannot update running batch call",
"data": 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
API Key for MCP server and external service authentication
API Secret for MCP server and external service authentication
Body
application/json
- Option 1
- Option 2
E.164 format
Required array length:
1 - 1000 elementsShow child attributes
Show child attributes
Maximum string length:
255agent_[uuid] format
Set true to send immediately. Use false/omit when scheduling with trigger_timestamp.
Unix timestamp (milliseconds). Required when scheduling (send_now false or omitted).
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Valid timezone, default UTC
Available options:
draft, scheduled, sent Response
Batch call created successfully
Show child attributes
Show child attributes
⌘I