FAQ

Where do I find my Aircall API credentials?

Log in to your Aircall Dashboard and go to Integrations > API Keys. You'll see your API ID and API Token listed there. You need Admin access to view this section — if you don't see it, ask your account admin.

What's the difference between the API ID and the API Token?

The API ID acts like a username and identifies your account. The API Token acts like a password and authenticates your requests. Coupler.io needs both to connect — entering only one will result in an authentication error.

Can I connect multiple Aircall accounts?

Yes. You can create separate importers in Coupler.io, each using a different set of API credentials. This is useful if your organization manages more than one Aircall account.

How far back can I pull historical call data?

Aircall's API supports historical data retrieval, and the range depends on your Aircall plan. Use the date picker in Coupler.io to set your start date. For very long date ranges, expect the initial import to take more time.

Why does the User availabilities entity not show historical data?

The User availabilities entity reflects the most recent availability status for each agent, not a full history of status changes. If you need to track availability over time, consider scheduling frequent imports and appending data to your destination rather than replacing it.

Can I get call recordings through Coupler.io?

Call recording URLs are included in the Calls entity as a field, provided recording is enabled on your Aircall plan and configured for your numbers. Coupler.io exports the URL — you access the actual recording file directly from Aircall's storage.

Does Coupler.io support real-time Aircall data?

Coupler.io works on a scheduled refresh model, not true real-time streaming. You can set refresh intervals as short as every 15 minutes, depending on your plan. For live call monitoring, use Aircall's native dashboard.

What happens if my API key expires or is regenerated?

Your scheduled data flows will fail with an authentication error. Go to your Coupler.io Sources, update the API credentials with the new values, and re-run the data flow to resume normal operation.

For details on available fields and metrics, see Data Overview. If you're running into connection or data problems, check Common Issues. For tips on structuring your imports, visit Best Practices.