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

# Create Outbound Call

> Initiate a new outbound call to a phone number.

<Note>
  Retrieve your API Key from your [VozAgent Dashboard](https://app.vozagent.ai/settings/api).
</Note>

Triggers an AI-powered outbound call. The assistant will call the specified phone number and handle the conversation based on its configuration. Requires an active subscription and the `calls:write` scope.

## Body parameters

<ParamField body="phone_number" type="string" required>
  The destination phone number to call (E.164 format, e.g., `+15551234567`).
</ParamField>

<ParamField body="assistant_id" type="string">
  The ID of the assistant to make the call. Either `assistant_id` or `assistant_name` is required.
</ParamField>

<ParamField body="assistant_name" type="string">
  The name of the assistant to make the call. Either `assistant_id` or `assistant_name` is required.
</ParamField>

<ParamField body="first_name" type="string">
  First name of the contact being called. Used for personalization.
</ParamField>

<ParamField body="last_name" type="string">
  Last name of the contact being called.
</ParamField>

<ParamField body="source" type="string">
  Lead source identifier (e.g., "website", "referral").
</ParamField>

<ParamField body="tags" type="string | string[]">
  Tags to associate with the contact. Can be a single string or an array of strings.
</ParamField>

<ParamField body="notes" type="string">
  Additional notes or context for the call. Can be used to provide the assistant with background information.
</ParamField>

## Response

Returns the created call object. The call will be initiated asynchronously. Status code: `201`.

<RequestExample>
  ```bash theme={null}
  curl -X POST https://api.vozagent.ai/v1/calls/outbound \
    -H "Authorization: Bearer <token>" \
    -H "Content-Type: application/json" \
    -d '{
      "phone_number": "+15551234567",
      "assistant_name": "Voz",
      "first_name": "John",
      "last_name": "Smith",
      "notes": "Interested in a kitchen remodel quote"
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "call_id": "call-a1b2c3d4-e5f6-a7b8",
    "status": "queued",
    "direction": "outbound",
    "to_phone": "+15551234567",
    "assistant_name": "Voz",
    "contact_id": "c1a2b3c4-d5e6-f7a8",
    "is_new_contact": false,
    "created_at": "2024-01-15T12:00:00Z"
  }
  ```
</ResponseExample>