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

# Introduction

> API to query campaigns, cases, and calls from your bots.

## Welcome

The Inceptia API lets you integrate and automate conversational campaign management: create campaigns, upload cases, check results, and download recordings.

<Card title="Getting started" icon="rocket" href="/en/api-reference/quickstart">
  Create your first campaign in 4 steps
</Card>

## Before you start

To use the API you need a user account with at least one bot assigned. Access is managed by your Inceptia administrator.

<Steps>
  <Step title="Request access">
    Contact your administrator and ask them to create a user with access to the bot you're going to integrate. Without that assignment, the API returns an empty bot list.
  </Step>

  <Step title="Get your credentials">
    Your administrator will share the email and password for you to authenticate with, and confirm which environment you can operate in (test or production).
  </Step>

  <Step title="Integrate">
    With that, you can follow the [Getting started](/en/api-reference/quickstart) guide.
  </Step>
</Steps>

## Servers

| Environment | URL                             |
| ----------- | ------------------------------- |
| Test        | `https://admintest.inceptia.ai` |
| Production  | `https://admin.inceptia.ai`     |

## Authentication

All endpoints (except login and refresh) require a JWT token in the header:

```
Authorization: Bearer <access_token>
```

You get the token by calling `POST /auth/login/` with your email and password. The token expires — use `POST /auth/token/refresh/` to renew it without authenticating again.

## Pagination

List endpoints use two strategies:

* **Cursor-based** (`next` / `previous` as URLs): campaigns.
* **Offset** (`count` + `next` / `previous`): cases, calls, and inbound.

Follow the `next` field in the response to get the next page.