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

# Voice AI Overview

> Create and manage AI-powered voice agents, configure call behaviors, and review call logs using the HoopAI Voice AI REST API.

The Voice AI API lets you programmatically create and manage AI voice agents — automated callers that handle inbound or outbound calls using configurable behaviors and actions. Use it to build custom voice automation, configure agent scripts, attach actions (such as transferring calls or booking appointments), and retrieve detailed call logs.

## Base URL

```
https://services.leadconnectorhq.com
```

## Authentication

All endpoints require a Bearer token and an API version header.

```bash theme={null}
Authorization: Bearer <access_token>
Version: 2021-04-15
```

See [OAuth 2.0](/api-reference/oauth/authorization) to obtain an access token.

## OAuth scopes

| Scope               | Access                                        |
| ------------------- | --------------------------------------------- |
| `voice-ai.readonly` | Read agents, call logs, and actions           |
| `voice-ai.write`    | Create, update, and delete agents and actions |

## Quick start

Create a new Voice AI agent:

```bash theme={null}
curl -X POST https://services.leadconnectorhq.com/voice-ai/agents   -H "Authorization: Bearer <access_token>"   -H "Version: 2021-04-15"   -H "Content-Type: application/json"   -d '{
    "locationId": "ve9EPM428h8vShlRW1KT",
    "name": "Sales Agent",
    "language": "en-US"
  }'
```

## Endpoints

| Method   | Path                                     | Description                |
| -------- | ---------------------------------------- | -------------------------- |
| `POST`   | `/voice-ai/agents`                       | Create a Voice AI agent    |
| `GET`    | `/voice-ai/agents`                       | List agents for a location |
| `GET`    | `/voice-ai/agents/{agentId}`             | Get agent details          |
| `PATCH`  | `/voice-ai/agents/{agentId}`             | Update an agent            |
| `DELETE` | `/voice-ai/agents/{agentId}`             | Delete an agent            |
| `GET`    | `/voice-ai/dashboard/call-logs`          | List call logs             |
| `GET`    | `/voice-ai/dashboard/call-logs/{callId}` | Get a call log by ID       |
| `POST`   | `/voice-ai/actions`                      | Create an agent action     |
| `GET`    | `/voice-ai/actions/{actionId}`           | Get an action              |
| `PUT`    | `/voice-ai/actions/{actionId}`           | Update an action           |
| `DELETE` | `/voice-ai/actions/{actionId}`           | Delete an action           |

## Related

* [Phone System API](/api-reference/phone-system/overview) — Manage phone numbers and number pools
* [Conversations API](/api-reference/conversations/overview) — Access call recordings and transcriptions
* [Contacts API](/api-reference/contacts/overview) — Look up contacts associated with calls