Skip to main content
POST
Programmatically initiate an outbound call from one of your AI assistants to a phone number. This is one of the most powerful features of Burki - it allows you to trigger AI-powered outbound calls from your application logic, enabling use cases like appointment reminders, lead follow-ups, and proactive customer outreach.

How It Works

  1. You send a request with the source phone number, destination number, and optional customization
  2. Burki resolves the assistant based on your parameters
  3. The call is placed through your configured telephony provider (Twilio, Telnyx, Vonage, or SIP)
  4. Your AI assistant handles the conversation automatically
Multi-Provider Support: This endpoint works with Twilio, Telnyx, Vonage, and BYO SIP Trunk. The system automatically uses the provider configured for the specified from_phone_number.

Request Body

Assistant Resolution

The system determines which assistant handles the call:
  1. If assistant_id is provided: Uses that specific assistant
  2. If phone number has a ConversationFlow: Uses the flow’s base assistant and live flow runtime
  3. If phone number has a direct assistant: Uses the assigned assistant

Examples

Minimal Request

With Custom Welcome Message

With Template Variables

With Assistant Override

Response

Error Responses

400 Bad Request

Missing or invalid parameters.

402 Payment Required

Insufficient account balance.

403 Forbidden

Phone number or assistant doesn’t belong to your organization.

404 Not Found

No assistant found for the phone number.

Use Cases

Appointment Reminders

Lead Follow-up

Bulk Outreach with Campaign

For large-scale outbound calling, consider using the Campaigns API which provides scheduling, retry logic, and analytics.

Authorizations

Authorization
string
header
required

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

Body

application/json

Request model for initiating an outbound call.

to_phone_number
string
required
welcome_message
string | null
agenda
string | null
from_phone_number
string | null
assistant_id
integer | null

Optional: Override the default assistant attached to the phone number. If not provided, uses the assistant assigned to from_phone_number.

variables
Variables · object | null

Custom variables for template substitution in welcome_message and agenda using {{variable}} syntax

Response

Successful Response

Response model for initiating an outbound call.

message
string
required
call_sid
string
required