DOCUMENTATION

Start a call with a configured outbound bot.

The bot calls the recipient through the organisation’s telephony connection.

Full API reference and interactive request explorer →

Request fields

Provide to, fromNumberSid, botId, and mode. deliver_specific_message also requires purposeMessage. scheduledFor is optional.

No browser audio session

Starting a bot call does not require your browser microphone. It creates a server-side action.

Eligibility and outcome

Inactive bots, unavailable numbers, exhausted allowance, or disallowed hours reject the action. Read /ai-calls/{id} for current status.

Pilot access requires verified organisation configuration. Never expose a live API key in frontend code.

View the versioned OpenAPI contract