​
Basic

This API allows you to initiate outbound phone calls from a specified Millis AI voice agent to any given phone number.

​
Prerequisites

Obtain your API key from your Millis AI Account.

​
API Details

  • Method: POST
  • URL: 
https://api-west.millis.ai/start_outbound_call
  • Headers:
Content-Type: application/json
Authorization: YOUR_API_KEY
  • Body:
{
  "from_phone": "one of your agent's phone number",
  "to_phone": "receiver's phone number",
  "metadata": {
    key: value
  }, // Optional: any extra data to attach to the session
  include_metadata_in_prompt: true/false // Optional: option to include the metadata in the agent's system prompt
}
Ensure the phone number includes the full international dialing format (e.g., +15555555555), with no dashes or spaces. (Only US phone nubers are supported)Retrieve your voice agent ID from the Agent Details page on the playground.title

​
Example Request using curl

curl -X POST https://api-west.millis.ai:8080/start_outbound_call \
-H "Content-Type: application/json" \
-H "Authorization: YOUR_API_KEY" \
-d '{"from_phone": "+1234567890", "to_phone": "+1987654321"}'