Consultants in a BoxAircallAircall guides
Aircall API

Aircall API: what the developer docs list

Short answer

Per Aircall's API reference on November 21, 2026, the Aircall Public API is a REST API at api.aircall.io/v1 over HTTPS. It supports OAuth and Basic Auth, covers users, calls, contacts, numbers, messages, campaigns, conversation intelligence and AI voice agents, and is limited to 120 requests per minute per company. Webhooks send events such as call.created.

Last reviewed against the vendors' own pages. See sources.

What can you do with the Aircall API?

Per Aircall's API reference, the reference lists these resource sections.

AreaWhat the docs list
People and teamsUsers (V1 and V2), Teams, Participants
Calls and conversationsCalls, Conversations, IVR Options, Numbers
MessagingMessages, High Volume Messages
ContactsContacts, Tags
CampaignsDialer Campaigns, Outbound Campaigns
Intelligence and AIConversation Intelligence, AI Voice Agents, Call AI Voice Agents, Analytics, Content
AccountCompany, 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.

Sources

Last reviewed . Vendor plans and prices change often; every product claim and price on this page was checked against the vendor pages below on that date. Anything we could not verify was left out.

  1. Aircall Public API reference (Aircall developers)
  2. Aircall pricing (Aircall)

Consultants in a Box is an independent consultancy. This page is not published or endorsed by Aircall. Prices shown are Aircall's listed prices, not ours. Aircall is a trademark of Aircall.

Setting up or moving to Aircall?

Start with the free business analysis, or book a call and we will talk through how your team uses the phone and a practical first step.

Book a free consultation

Tell us about your team and the software you need help with. We'll follow up to schedule a time to talk.

Open the form on its own page

Talk to a person

The fastest way is to pick a time. Prefer to write? Leave a message and we will email you back, usually the same business day.

Book a free call

By sending this you agree to our Terms and Privacy Policy.