> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getbutter.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Make Outbound Call

Initiate an outbound call from an agent to a destination number.

<ParamField body="call_to" type="string" required>
  The destination phone number in E.164 format (e.g., `+12345678900`).
</ParamField>

<ParamField body="call_from" type="string" required>
  The source phone number (must be one of your imported numbers) in E.164 format.
</ParamField>

<ParamField body="agent_id" type="string" required>
  The ID of the agent to handle the call.
</ParamField>

<ParamField body="prompt_variables" type="object">
  Optional key-value pairs to inject into the agent's prompt context for this call.
</ParamField>

### Response

<ResponseField name="success" type="boolean">
  Indicates if the call initiation was successful.
</ResponseField>

<ResponseField name="call_sid" type="string">
  The unique identifier for the call.
</ResponseField>

<ResponseField name="status" type="string">
  Initial status of the call (e.g., `initiated`, `calling`).
</ResponseField>

<RequestExample>
  ```json Request theme={null}
  {
    "call_to": "+15559876543",
    "call_from": "+15551234567",
    "agent_id": "agent_abc",
    "prompt_variables": {
      "customer_name": "Alice",
      "appointment_time": "3:00 PM"
    }
  }
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "success": true,
    "call_sid": "call_xyz789",
    "to": "+15559876543",
    "from": "+15551234567",
    "agent_id": "agent_abc",
    "call_type": "twilio",
    "status": "initiated"
  }
  ```
</ResponseExample>