Make a call

Trigger a single outbound AI call
View as Markdown

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

Endpoint

POST /v1/call/make-call

Request

$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

FieldRequiredTypeDescription
campaign_idYesuuidUUID of the campaign under which the call is placed.
toYesstringDestination phone number.
metadataNoobjectArbitrary 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 for details.

After the call

Use the Conversations API to retrieve conversation data produced by the call.