How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Aircall

Aircall Webhooks API

Register, list and manage event subscriptions.

Documentation Provider Profile APIs.io AsyncAPI GitHub

This event API exposes 1 operation across 1 channel, and defines 96 schemas. It is described by AsyncAPI 2.6.0, at version 1.0.0.

The API connects through a single server, {webhookUrl} (https).

1 operations 1 channels 96 schemas

Metadata

The identity and technical contract details declared by the specification.

Specification
AsyncAPI 2.6.0
API Version
1.0.0
Base URL
https://api.aircall.io/v1
Contact
Aircall Developer
License
Aircall Terms of Service
Resource Areas
1

Channels & Operations 1

Across 1 channel, the API surfaces 1 operation. Each is listed below with its action, channel, parameters, and response codes.

Channels 1
PUB
/aircall/webhook
Receive an Aircall webhook event
receiveAircallWebhook body

Messages & Schemas 96

The contract defines 96 schemas that model the data carried by its messages. The most detailed are Call (32 properties), Message (15 properties), Number (13 properties), User (13 properties). Each schema is shown below with its type and property counts.

CallCreated
message
A new call has been initiated (inbound or outbound).
CallRingingOnAgent
message
The call is ringing on an agent's phone.
CallAgentDeclined
message
An agent declined the incoming call.
CallAnswered
message
The call has been answered.
CallTransferred
message
The call was transferred between Aircall users.
CallExternalTransferred
message
The call was transferred to an external phone number.
CallUnsuccessfulTransfer
message
A transfer attempt did not complete successfully.
CallHungup
message
One party hung up the call.
CallEnded
message
The call session has fully ended.
CallVoicemailLeft
message
A voicemail was recorded for the call.
CallCommented
message
A note/comment was added to the call.
CallTagged
message
A tag was applied to the call.
CallUntagged
message
A tag was removed from the call.
CallAssigned
message
The call was assigned to a user.
CallArchived
message
The call was archived / marked as resolved.
CallHold
message
The call was placed on hold.
CallUnhold
message
The call was resumed from hold.
CallIvrOptionSelected
message
The caller selected an option in an IVR menu.
CallCommAssetsGenerated
message
Recording / voicemail asset links are available for the call.
ContactCreated
message
A new contact was added to the shared address book.
ContactUpdated
message
A contact's information was modified.
ContactDeleted
message
A contact was removed from the shared address book.
NumberCreated
message
A new phone number was added to the workspace.
NumberDeleted
message
A phone number was removed from the workspace.
NumberOpened
message
The number's status switched to open. Deprecated for Smartflows-enabled lines.
NumberClosed
message
The number's status switched to closed. Deprecated for Smartflows-enabled lines.
UserCreated
message
A new Aircall user was provisioned.
UserDeleted
message
An Aircall user was deprovisioned.
UserConnected
message
The user came online.
UserDisconnected
message
The user went offline.
UserOpened
message
The user opened the Aircall phone app.
UserClosed
message
The user closed the Aircall phone app.
UserWutStart
message
Wrap-up time began for the user.
UserWutEnd
message
Wrap-up time ended for the user.
UserCreatedV2
message
V2 variant of user.created. Excludes the numbers array present in V1.
UserDeletedV2
message
V2 variant of user.deleted.
UserConnectedV2
message
V2 variant of user.connected.
UserDisconnectedV2
message
V2 variant of user.disconnected.
UserOpenedV2
message
V2 variant of user.opened.
UserClosedV2
message
V2 variant of user.closed.
UserWutStartV2
message
V2 variant of user.wutstart. Includes lastcallid when available.
UserWutEndV2
message
V2 variant of user.wutend. Includes lastcallid when available.
TeamCreated
message
A new team was created.
TeamDestroyed
message
A team was deleted.
MessageSent
message
A message was sent from an Aircall number (SMS, MMS or WhatsApp).
MessageReceived
message
A message was received on an Aircall number.
MessageStatusUpdated
message
A message's delivery status changed.
GroupMessageSent
message
A group message was sent from an Aircall number.
GroupMessageReceived
message
A group message was received on an Aircall number.
GroupMessageStatusUpdated
message
A group message's delivery status changed.
IntegrationDeleted
message
A third-party integration was disconnected from the workspace.
SentimentCreated
message
Sentiment analysis was generated for a call.
SummaryCreated
message
A summary was generated for a call.
TopicsCreated
message
Key topics were identified for a call.
TranscriptionCreated
message
A transcription was generated for a call.
ActionItemCreated
message
An action item was extracted from a call.
PlaybookResultCreated
message
A playbook evaluation result was created for a call.
PlaybookResultUpdated
message
A playbook evaluation result was updated for a call.
RealtimeTranscriptionUtterancesReceived
message
Real-time utterances streamed during an active call.
CustomSummaryResultCreated
message
A custom summary result was created for a call.
CustomSummaryResultUpdated
message
A custom summary result was updated for a call.
CallEvaluationCreated
message
A call evaluation was created.
CallEvaluationUpdated
message
A call evaluation was updated.
AiVoiceAgentStarted
message
An AI Voice Agent call was initiated.
AiVoiceAgentEnded
message
An AI Voice Agent call completed.
AiVoiceAgentEscalated
message
An AI Voice Agent call was escalated to a human agent.
AiVoiceAgentSummary
message
Intake-question answers / summary delivered by the AI Voice Agent.
AnalyticsReportCreated
message
An analytics export job completed successfully.
AnalyticsReportFailed
message
An analytics export job failed.
EventEnvelope
object
Common envelope shared by every Aircall webhook event. The specific event type is identified by the event field; the data field contains the affected object an…
5 properties 5 required
CallEvent
object
ContactEvent
object
NumberEvent
object
UserEvent
object
UserEventV2
object
TeamEvent
object
MessageEvent
object
IntegrationEvent
object
ConversationIntelligenceEvent
object
AiVoiceAgentEvent
object
AnalyticsEvent
object
Call
object
Aircall Call object as delivered on webhook events. Fields mirror the REST /v1/calls resource. Not every field is present on every event; for example answereda…
32 properties
Contact
object
Aircall Contact object as delivered on webhook events.
11 properties
PhoneNumber
object
3 properties
Email
object
3 properties
Number
object
Aircall Number object as delivered on webhook events.
13 properties
User
object
Aircall User object (V1) as delivered on webhook events. Includes the numbers array that the V2 variant omits.
13 properties
UserV2
object
Aircall User object (V2) as delivered on .v2 webhook events. Compared to V1, the numbers array is omitted. The lastcallid field is surfaced on wrap-up time eve…
13 properties
Team
object
Aircall Team object.
5 properties
Tag
object
4 properties
Comment
object
4 properties
Message
object
Aircall Message object for SMS, MMS, WhatsApp and group messages. Carried on message. and groupmessage. events.
15 properties
Integration
object
Third-party integration record carried on integration.deleted.
4 properties
ConversationIntelligenceResult
object
Generic payload wrapper for Conversation Intelligence webhook events (transcription, summary, sentiment, topics, action items, playbook results, real-time utte…
4 properties
AiVoiceAgentResult
object
Payload carried on aivoiceagent. events. Includes references to the underlying call and the AI Voice Agent configuration that handled it.
9 properties
AnalyticsReport
object
Payload carried on analytics.reportcreated and analytics.reportfailed.
5 properties

Specification

The full machine-readable AsyncAPI contract behind this narrative.

Source

aircall-webhooks-asyncapi.yml Raw ↑
#Webhook#Event
← Back to A APIs
API Details
ID
aircall:aircall-webhooks-api
Base URL
https://api.aircall.io/v1
Docs
https://developer.aircall.io/api-references/
Provider
Aircall
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=aircall-aircall-webhooks-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/aircall-aircall-webhooks-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have. Your account

Where this information came from

This is an independent, third-party profile of Aircall Webhooks API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.