> For the complete documentation index, see [llms.txt](https://docs.coupler.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.coupler.io/sources/category/sales/aircall.md).

# Aircall

Aircall is a cloud-based phone system built for sales and support teams. It lets you manage calls, track agent activity, and monitor team performance — all from one platform. Connecting Aircall to Coupler.io lets you pull that data into your spreadsheets, dashboards, or data warehouse automatically.

**Why connect Aircall to Coupler.io?**

* Export call logs, user activity, and team data without manual downloads
* Schedule automatic refreshes so your reports always reflect the latest data
* Combine Aircall data with CRM or helpdesk data for a fuller picture of customer interactions
* Build dashboards in Google Sheets, Looker Studio, Claude, or other destinations

## Prerequisites

Before you connect, make sure you have:

* An active Aircall account with **Admin** access
* Your Aircall **API ID** and **API Token** (found in your Aircall Dashboard under **Integrations > API Keys**)

## Quick start

{% hint style="success" %}
Start with the **Calls** entity to get a full log of inbound and outbound calls. It's the most commonly used report and gives you an immediate view of team activity.
{% endhint %}

{% stepper %}
{% step %}
**Create a new data flow in Coupler.io** and select **Aircall** as your source.
{% endstep %}

{% step %}
**Connect your Aircall account.** Enter your Aircall **API ID** and **API Token** in the connection fields. You can find these in your Aircall Dashboard under **Integrations > API Keys**. Click **Save** to confirm the connection.
{% endstep %}

{% step %}
**Choose an entity.** Select the data you want to import — Calls, Users, Teams, Contacts, and more. See the table below for a full list.
{% endstep %}

{% step %}
**Set a start date.** Use the date picker to define how far back you want to pull data. This controls which records are included in your import.
{% endstep %}

{% step %}
**Configure your destination and schedule.** Choose where your data should land (Google Sheets, BigQuery, ChatGPT, etc.) and run your first import.
{% endstep %}
{% endstepper %}

## Available entities

| Entity              | What it contains                                                          |
| ------------------- | ------------------------------------------------------------------------- |
| Calls               | Full call log including duration, direction, status, tags, and timestamps |
| Companies           | Company records linked to your contacts                                   |
| Contacts            | Contact details associated with calls                                     |
| Numbers             | Aircall phone numbers configured in your account                          |
| Tags                | Tags used to categorize calls                                             |
| User availabilities | Real-time and historical availability status per agent                    |
| Users               | Agent profiles, roles, and settings                                       |
| Teams               | Team structure and membership                                             |
| Webhooks            | Webhook configurations set up in your Aircall account                     |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.coupler.io/sources/category/sales/aircall.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.