Campaigns are stateful orchestration objects, not static configs.

Use bulk_call_campaigns to manage dial strategy, schedule windows, and downstream reporting flows.

Endpoint families

Core CRUD: list/create/get/update
Lifecycle controls: launch, pause, resume, cancel
Cloning: clone, clone_prefill, save_as_template
Runtime insight: tasks, analytics, dispatch_health
Output paths: results_export, collection export
Planning helpers: capacity_preview, audience_timezone_analysis

Recommended lifecycle workflow

Create in draft state

Validate agent assignment, number pool, schedule timezone, and concurrency.

Run preflight checks

Use capacity and timezone analysis before first launch.

Launch and monitor dispatch health

Validate task creation, first outcomes, and number health.

Pause/resume for controlled tuning

Tune script, schedule, or concurrency using pause-resume loops.

Export and reconcile

Pull results export and analytics for CRM and BI handoff.

Create and launch

curl -X POST "https://api.callaro.ai/api/v1/bulk_call_campaigns" \
  -H "X-Api-Key: $CALLARO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Q2 Pipeline Reactivation","agent_id":42,"timezone":"Asia/Kolkata","campaign_phone_number_ids":[101,102],"concurrency_limit":3}'

curl -X POST "https://api.callaro.ai/api/v1/bulk_call_campaigns/123/launch" \
  -H "X-Api-Key: $CALLARO_API_KEY"

const create = await fetch('https://api.callaro.ai/api/v1/bulk_call_campaigns', {
  method: 'POST',
  headers: {
    'X-Api-Key': process.env.CALLARO_API_KEY,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'Q2 Pipeline Reactivation',
    agent_id: 42,
    timezone: 'Asia/Kolkata',
    campaign_phone_number_ids: [101, 102],
    concurrency_limit: 3
  })
});
const created = await create.json();
await fetch(`https://api.callaro.ai/api/v1/bulk_call_campaigns/${created.data.id}/launch`, {
  method: 'POST',
  headers: { 'X-Api-Key': process.env.CALLARO_API_KEY }
});

Monitor and control

curl "https://api.callaro.ai/api/v1/bulk_call_campaigns?page=1&per_page=20" -H "X-Api-Key: $CALLARO_API_KEY"
curl "https://api.callaro.ai/api/v1/bulk_call_campaigns/123/dispatch_health" -H "X-Api-Key: $CALLARO_API_KEY"
curl "https://api.callaro.ai/api/v1/bulk_call_campaigns/123/analytics?from=2026-04-01&to=2026-04-30" -H "X-Api-Key: $CALLARO_API_KEY"
curl -X POST "https://api.callaro.ai/api/v1/bulk_call_campaigns/123/pause" -H "X-Api-Key: $CALLARO_API_KEY"
curl -X POST "https://api.callaro.ai/api/v1/bulk_call_campaigns/123/resume" -H "X-Api-Key: $CALLARO_API_KEY"

await Promise.all([
  fetch('https://api.callaro.ai/api/v1/bulk_call_campaigns?page=1&per_page=20', { headers: { 'X-Api-Key': process.env.CALLARO_API_KEY } }),
  fetch('https://api.callaro.ai/api/v1/bulk_call_campaigns/123/dispatch_health', { headers: { 'X-Api-Key': process.env.CALLARO_API_KEY } }),
  fetch('https://api.callaro.ai/api/v1/bulk_call_campaigns/123/analytics?from=2026-04-01&to=2026-04-30', { headers: { 'X-Api-Key': process.env.CALLARO_API_KEY } }),
  fetch('https://api.callaro.ai/api/v1/bulk_call_campaigns/123/pause', { method: 'POST', headers: { 'X-Api-Key': process.env.CALLARO_API_KEY } })
]);

State transition guidance

Current state	Allowed action	Operator intent
Draft	Launch	Begin first execution window
Running	Pause	Temporary stop for tuning/investigation
Paused	Resume or Cancel	Continue or terminate safely
Running/Paused	Cancel	End campaign and prevent further dispatch

Failure and rollback patterns

If launch fails with validation errors, fix campaign configuration before retrying.
If dispatch health degrades, pause campaign and investigate number health, schedule windows, or contact quality.
If analytics mismatch appears, compare webhook dedupe logs with tasks and results export output.

Overview

Resource Guides

Generated Endpoints

Campaigns API

Campaigns are stateful orchestration objects, not static configs.

Endpoint families

Recommended lifecycle workflow

Create and launch

Monitor and control

State transition guidance

Failure and rollback patterns

​Campaigns are stateful orchestration objects, not static configs.

​Endpoint families

​Recommended lifecycle workflow

​Create and launch

​Monitor and control

​State transition guidance

​Failure and rollback patterns

Campaigns are stateful orchestration objects, not static configs.

Endpoint families

Recommended lifecycle workflow

Create and launch

Monitor and control

State transition guidance

Failure and rollback patterns