> 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.

# Quickstart

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.

#### Create a campaign

Sign in to [app.hollr.ai](https://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.

#### 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.

#### Get an API key

Get your API key from [app.hollr.ai](https://app.hollr.ai) and export it so the examples below can use it.

```bash
export HOLLR_API_KEY="your-key-here"
```

See [authentication](/authentication) for more on API keys.

#### Trigger a call

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

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

For larger batches, use the [bulk calls](/making-calls) endpoint.

#### Read the conversation

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

```bash
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](/making-calls)

Trigger single or bulk calls programmatically

#### [Conversations](/conversations)

Retrieve call records and conversation data