Make Outbound Calls via API

Make your agent call customers. Link a phone number for caller ID, then schedule calls via API with priority ordering and custom data. What you’ll learn: How to set up outbound calling, schedule calls via API, and monitor call status.

Prerequisites

Before making outbound calls:

Agent configured and enabled
Phone number added with valid SIP credentials
Phone number linked to agent for outbound

Phone Numbers

Complete guide to adding phone numbers and SIP credentials

Link a phone number for outbound calls

Set the caller ID your agent uses when making calls:

Dashboard
API

Go to Agents → Select agent → Edit
Find Outbound Phone Number section
Select a phone number from the dropdown
Click Save Agent

// Link phone number to agent for outbound calls
await fetch(
  `https://blackbox.dasha.ai/api/v1/sip-phone-numbers/${phoneNumberId}/agent-link?agentId=${agentId}&mode=replaceOutbound`,
  {
    method: 'PUT',
    headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
  }
);

Each agent can have one outbound phone number. Linking a new number replaces the previous one.

Schedule a call

Quick test from dashboard

Test your agent before running campaigns:

Go to your agent’s page
Click Test Call
Enter the target phone number
Click Call — starts immediately

Schedule via API

const response = await fetch(
  'https://blackbox.dasha.ai/api/v1/calls?agentId=YOUR_AGENT_ID',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      endpoint: '+15551234567',
      priority: 5,
      additionalData: {
        customerId: 'cust_123',
        campaignId: 'spring_promo'
      }
    })
  }
);

const call = await response.json();
console.log('Call scheduled:', call.callId);

Schedule bulk calls

Schedule multiple calls in one request:

const response = await fetch(
  'https://blackbox.dasha.ai/api/v1/calls/bulk?agentId=YOUR_AGENT_ID',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      calls: [
        { endpoint: '+15551234567', priority: 5, additionalData: { name: 'John' } },
        { endpoint: '+15559876543', priority: 5, additionalData: { name: 'Jane' } },
        { endpoint: '+15555555555', priority: 5, additionalData: { name: 'Bob' } }
      ]
    })
  }
);

const result = await response.json();
console.log(`Scheduled: ${result.successCount}, Failed: ${result.failedCount}`);

Monitor call status

Check individual call

const call = await fetch(
  `https://blackbox.dasha.ai/api/v1/calls/${callId}`,
  { headers: { 'Authorization': 'Bearer YOUR_API_KEY' } }
).then(r => r.json());

console.log('Status:', call.status);
// Created → Queued → Pending → InProgress → Completed/Failed

View queue

const queue = await fetch(
  `https://blackbox.dasha.ai/api/v1/calls/queue/list?agentId=${agentId}`,
  { headers: { 'Authorization': 'Bearer YOUR_API_KEY' } }
).then(r => r.json());

console.log(`Calls in queue: ${queue.totalCount}`);
queue.items.forEach(call => {
  console.log(`  ${call.endpoint} - Priority ${call.priority}`);
});

Receive webhooks

Configure webhooks for real-time status updates:

// When scheduling the call
{
  endpoint: '+15551234567',
  completedWebHook: 'https://your-server.com/call-completed',
  failedWebHook: 'https://your-server.com/call-failed'
}

Webhook Events

Complete webhook payload reference

Cancel a scheduled call

Cancel calls that haven’t started yet:

await fetch(
  `https://blackbox.dasha.ai/api/v1/calls/${callId}`,
  {
    method: 'DELETE',
    headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
  }
);

Only calls in Created, Queued, or Pending status can be canceled. Calls already InProgress cannot be canceled via API.

Call lifecycle

Created → Queued → Pending → InProgress → Completed
                                       ↘ Failed

Status	Description
Created	Call record created, not yet queued
Queued	Waiting in queue based on priority
Pending	About to be dialed
InProgress	Call connected, agent speaking
Completed	Call finished successfully
Failed	Call failed (busy, no answer, error)

Troubleshooting

Calls not scheduling

Symptom	Fix
400 Bad Request	Verify phone number format (E.164: +15551234567)
404 Agent Not Found	Check agentId is correct
”No outbound config”	Link a phone number to the agent for outbound

Calls stuck in queue

Symptom	Fix
Calls not processing	Check agent is enabled
Slow queue processing	Check business hours schedule
Hitting concurrency limit	Upgrade plan or reduce call volume

Low answer rates

Symptom	Fix
Many “No Answer”	Call during optimal hours (10am-4pm local)
Calls marked spam	Use local area code numbers
Quick hang-ups	Improve greeting, reduce agent latency

What’s next

Phone Numbers

Add phone numbers for caller ID

Caller ID

Configure display names

Call History

Monitor call results

Webhooks

Handle call completion events

Introduction

Create

Test

Deploy

Monitor

Advanced Features

Troubleshooting

Prerequisites

Phone Numbers

Link a phone number for outbound calls

Schedule a call

Quick test from dashboard

Schedule via API

Schedule bulk calls

Monitor call status

Check individual call

View queue

Receive webhooks

Webhook Events

Cancel a scheduled call

Call lifecycle

Troubleshooting

Calls not scheduling

Calls stuck in queue

Low answer rates

What’s next

Phone Numbers

Caller ID

Call History

Webhooks

​Prerequisites

Phone Numbers

​Link a phone number for outbound calls

​Schedule a call

​Quick test from dashboard

​Schedule via API

​Schedule bulk calls

​Monitor call status

​Check individual call

​View queue

​Receive webhooks

Webhook Events

​Cancel a scheduled call

​Call lifecycle

​Troubleshooting

​Calls not scheduling

​Calls stuck in queue

​Low answer rates

​What’s next

Phone Numbers

Caller ID

Call History

Webhooks

Prerequisites

Link a phone number for outbound calls

Schedule a call

Quick test from dashboard

Schedule via API

Schedule bulk calls

Monitor call status

Check individual call

View queue

Receive webhooks

Cancel a scheduled call

Call lifecycle

Troubleshooting

Calls not scheduling

Calls stuck in queue

Low answer rates

What’s next