Get started

Quickstart

Set up a campaign and agent, then trigger your first HollrAI call
View as Markdown

Campaigns and agents are created in the HollrAI platform. The API is used to trigger calls under an already-configured campaign and to read the resulting conversations.

1

Create a campaign

Sign in to app.hollr.ai and create a campaign, for example “Lead Qualification”. A campaign is the container you’ll use to organize calls and attach an agent to.

Copy the campaign ID — you’ll use it in every API call below.

2

Create an agent under the campaign

Still in the platform, create the AI voice agent for the “Lead Qualification” campaign. Set its name, opening message, system prompt, voice, and the languages it should support.

3

Get an API key

Get your API key from app.hollr.ai and export it so the examples below can use it.

$export HOLLR_API_KEY="your-key-here"

See authentication for more on API keys.

4

Trigger a call

Trigger a single outbound call to a phone number using the agent attached to the campaign.

$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": {
>      "customerId": "CUST-4821"
>    }
>  }'

For larger batches, use the bulk calls endpoint.

5

Read the conversation

After the call, retrieve the conversation record to inspect what happened during the call.

$curl -X POST "https://api.hollr.ai/v1/conversation/conversations/campaign" \
>  -H "hollr-api-key: $HOLLR_API_KEY" \
>  -H "Content-Type: application/json" \
>  -d '{
>    "campaignId": "CAMPAIGN_ID"
>  }'

The conversation record can include the transcript, AI summary, sentiment, recording information, call identifiers, and other call data.

Next steps

Making calls

Trigger single or bulk calls programmatically

Conversations

Retrieve call records and conversation data