> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.hollr.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.hollr.ai/_mcp/server.

# Make a call

Use the Calls API to trigger one outbound AI call using an agent configured for a campaign.

## Endpoint

```text
POST /v1/call/make-call
```

## Request

```bash
curl -X POST https://api.hollr.ai/v1/call/make-call \
  -H "hollr-api-key: $HOLLR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "campaign_id": "CAMPAIGN_ID",
    "to": "+15551234567",
    "metadata": {
      "orderId": "ORD-4821",
      "customerId": "CUST-1042"
    }
  }'
```

### Request body

| Field         | Required | Type     | Description                                          |
| ------------- | -------- | -------- | ---------------------------------------------------- |
| `campaign_id` | Yes      | `uuid`   | UUID of the campaign under which the call is placed. |
| `to`          | Yes      | `string` | Destination phone number.                            |
| `metadata`    | No       | `object` | Arbitrary metadata associated with the call request. |

The campaign and its agent must already be configured in HollrAI.

## Response

The endpoint passes through the response returned by HollrAI's underlying call server. The API reference therefore exposes the response as an open object rather than assuming a fixed response schema.

## Limits

`make-call` is subject to the API rate limit of 60 requests/minute per API key and a maximum of 5 concurrent calls per API key.

See [Errors and rate limits](/errors-and-rate-limits) for details.

## After the call

Use the [Conversations API](/conversations) to retrieve conversation data produced by the call.