What can you do with the Aircall API?
Per Aircall's API reference, the reference lists these resource sections.
| Area | What the docs list |
|---|---|
| People and teams | Users (V1 and V2), Teams, Participants |
| Calls and conversations | Calls, Conversations, IVR Options, Numbers |
| Messaging | Messages, High Volume Messages |
| Contacts | Contacts, Tags |
| Campaigns | Dialer Campaigns, Outbound Campaigns |
| Intelligence and AI | Conversation Intelligence, AI Voice Agents, Call AI Voice Agents, Analytics, Content |
| Account | Company, Integrations, Webhooks |
From Aircall's API reference, November 21, 2026. The docs note that User V1 endpoints are being deprecated in favor of User V2. The reference is long and we read its opening portion, so some resources may not be listed here.
How do authentication and limits work?
The docs describe two authentication methods and a per-company request limit.
- Basic Auth: an api_id and api_token, for Aircall customers working with their own account.
- OAuth 2.0: for technology partners building apps for multiple companies.
- Rate limit: 120 requests per minute per company, with X-AircallApi-Limit, X-AircallApi-Remaining and X-AircallApi-Reset response headers. The docs say higher limits are available on request.
- Pagination: 20 results per page by default and 50 at most; Calls and Contacts lists are capped at 10,000 items.
- Plan: Aircall's pricing page lists full API access from Professional.
Reviewed November 21, 2026.
Which webhook events does Aircall send?
Aircall can call an endpoint you choose each time an event occurs on an account.
- Calls: call.created, call.answered, call.ended, call.voicemail_left, call.tagged, call.commented and others.
- Messages and contacts: message.sent, message.received, contact.created, contact.updated.
- Conversation intelligence: transcription.created, summary.created, sentiment.created, topics.created.
- AI agents: ai_voice_agent.started, ai_voice_agent.ended and ai_voice_agent.escalated.
The part of the docs we read did not describe how webhook requests are signed or verified, so we make no claim about it. Read the Webhooks section before you build.
What do teams build with it?
The usual projects connect calls and messages to the systems where work is tracked.
We build these with the workflow automation service. For plan prices, see Aircall pricing; for the ready-made HubSpot connection, see Aircall HubSpot integration.
- Log calls and texts to a CRM that the built-in integrations do not cover.
- Create tasks from call summaries and transcripts.
- Alert a team channel when a voicemail is left.
Frequently asked questions
Does Aircall have an API?
Yes. Aircall's developer docs list a REST API at api.aircall.io/v1 covering users, calls, contacts, numbers, messages, campaigns, conversation intelligence and AI voice agents.
How does the Aircall API authenticate?
The docs list OAuth 2.0 for technology partners and Basic Auth with an api_id and api_token for customers using their own account.
What is the Aircall API rate limit?
The docs list 120 requests per minute per company, with higher limits available on request.
Can you connect Aircall to our systems?
Yes. We build the automations that log calls and messages, create follow-up tasks and keep records in sync. Book a call to start.
Need help with Aircall?
We help small and mid-size teams choose, connect and automate their phone system. See our Aircall guides and services, and the workflow automation service.



