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

# Aircall

> Connect Aircall to your Atako agents — 12 read and 4 write actions.

Let your agents read calls, users, numbers, teams and tags, search calls and shared contacts, comment and tag calls, and create or update contacts through the Aircall Public API.

## Connection

* **Authentication**: API key (API ID:API token).

<Note>
  Aircall Dashboard (admin) → Integrations & API → API Keys → Add API key. Aircall shows an API ID and an API token — the token is displayed only once, copy it right away. Enter the credential as api\_id:api\_token (the two values joined by a colon). The key acts on the whole company account.

  See [Aircall's documentation](https://developer.aircall.io/api-references/#basic-auth-aircall-customers).
</Note>

## Read actions (12)

| Action                  | Description                                                                                                                                                                                                      |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `get_call`              | Get one call with its details: participants, duration, tags, comments, recording and voicemail links.                                                                                                            |
| `get_company`           | Get the company behind the key: name, number of users and number of phone numbers.                                                                                                                               |
| `get_user_availability` | Get the detailed availability of one user: available, offline, do\_not\_disturb, in\_call or after\_call\_work.                                                                                                  |
| `list_calls`            | List the calls of the company: direction, status, duration, number, user, contact, tags, comments, recording. Use from/to (UNIX timestamps) to stay under the 10,000-call cap. Paginated (page, per\_page ≤ 50). |
| `list_contacts`         | List the shared contacts of the company with their phone numbers and emails. Use from/to to stay under the 10,000-contact cap. Paginated (page, per\_page ≤ 50).                                                 |
| `list_numbers`          | List the phone numbers (lines) of the company with their id, name, digits, country, time zone, availability status (open, custom, closed) and linked users. Paginated.                                           |
| `list_tags`             | List the call tags of the company (id, name, color, description) — ids used by add\_call\_tags and search\_calls.                                                                                                |
| `list_teams`            | List the teams of the company (id, name) with their member users.                                                                                                                                                |
| `list_users`            | List the users (agents) of the company with their id, name, email, availability status and numbers. Paginated (page, per\_page ≤ 50).                                                                            |
| `ping`                  | Check that the Aircall credential works — answers \{ "ping": "pong" }.                                                                                                                                           |
| `search_calls`          | Search calls by direction, user, phone number or tags (tags are ANDed: the call must carry all of them), within an optional from/to window. Paginated.                                                           |
| `search_contacts`       | Search the shared contacts by phone number or email address. Paginated.                                                                                                                                          |

## Write actions (4)

| Action             | Description                                                                                                                                                                                                                                                        |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `add_call_comment` | Add a comment (note) to a call. A call holds at most 5 comments (a 6th answers 400); a comment cannot be edited nor deleted afterwards, and emojis are removed.                                                                                                    |
| `add_call_tags`    | Tag a call with one or more existing tags (tag ids from list\_tags — tags are created by admins in the Dashboard).                                                                                                                                                 |
| `create_contact`   | Create a shared contact (visible to the whole company). phone\_numbers is required (1–20 \{ label, value } objects, value in E.164); emails is optional (up to 20 \{ label, value }). Posting the same payload twice creates a duplicate — search\_contacts first. |
| `update_contact`   | Update a shared contact's first name, last name, company name or information (Aircall uses POST, not PUT, here). Phone numbers and emails cannot be changed through this action.                                                                                   |

## Permissions

Every action above must be explicitly granted to an agent before it can be used. See [Permissions](/integrations/permissions) for the grant model and [Security](/integrations/security) for how credentials are protected.

***

*Last reviewed against the provider API: September 2026.*