Aircall - Atako

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

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.

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 for the grant model and Security for how credentials are protected.

Last reviewed against the provider API: September 2026.