Calls
Initiate Call
Initiates an outbound call from an assistant to a specified phone number. This endpoint is protected and requires authentication.
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
- You send a request with the source phone number, destination number, and optional customization
- Burki resolves the assistant based on your parameters
- The call is placed through your configured telephony provider (Twilio, Telnyx, Vonage, or SIP)
- 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:- If
assistant_idis provided: Uses that specific assistant - If phone number has a ConversationFlow: Uses the flow’s base assistant and live flow runtime
- 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
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
Request model for initiating an outbound call.
Optional: Override the default assistant attached to the phone number. If not provided, uses the assistant assigned to from_phone_number.
Custom variables for template substitution in welcome_message and agenda using {{variable}} syntax