---
updatedAt: 2026-07-29T09:49:23.000Z
agentTools:
  projectIndex: https://developer.aircall.io/llms.txt
---

# Overview

## Getting Started

Your connected systems shouldn't have to ask Aircall what happened — they should already know. <Glossary>Webhooks</Glossary> let you listen to Aircall events in real time, so your systems can react the moment something changes: a call ends, a message arrives, an agent misses a call, a user uninstalls your app.

Instead of polling the API, Aircall pushes a POST request to your desired endpoint for each event as it happens. You decide which events to listen to, and what to do with them.

## Creating webhooks

There are two ways to create webhooks on an Aircall account.

<Cards>
  <Card title="From the dashboard" href="https://support.aircall.io/en-gb/articles/20834438482333" icon="fa-rocket">
    Any admin can set up a webhook manually from the Aircall Dashboard. This is useful for quick testing, one-off setups or with connector tools such as Zapier or Make. See the <Anchor target="_blank" href="https://support.aircall.io/en-gb/articles/20834438482333">Help Center article</Anchor> for step-by-step instructions.
  </Card>

  <Card title="Via the API" href="https://developers.aircall.io/api-references/#create-a-webhook" icon="fa-code">
    Register a webhook programmatically on a user's account without any manual steps — the recommended approach for technology partners building integrations. See [Build event-driven integrations with webhooks](#) or the <Anchor target="_blank" href="https://developers.aircall.io/api-references/#payload">API Reference</Anchor> for details.
  </Card>
</Cards>

## Commonly used call events

For the full list of webhook events, see the [API resources](https://developers.aircall.io/api-references/#webhooks).

![Timeline of Aircall call events and conversation intelligence events, showing live call events, post-call processing, and the order in which transcription, summary, topics, and communication assets become available.](https://files.readme.io/674f9a3122f8114c7ac3d2a5e7f2135346fa4a70b7bae17cd659ce02ea0fd510-figma-call-flow_1_2.png)

### Call events

| Event                        | When it fires                                                                                                                                            |
| :--------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `call.created`               | A user or system starts a new inbound or outbound call.                                                                                                  |
| `call.answered`              | An agent answers an inbound call, or a recipient answers an outbound call.                                                                               |
| `call.hungup`                | Fires immediately when a call ends. Use this event for real-time dashboards and live agent status.                                                       |
| `call.ended`                 | Fires about 30 seconds after a call ends, once Aircall has finalized the call data (duration, recording, and more). Use this event to sync call records. |
| `call.comm_assets_generated` | Fires when recording or voicemail links are ready. Use this event if those assets are not yet available in `call.ended`.                                 |
| `call.transferred`           | An agent transfers a call to another agent or number.                                                                                                    |
| `call.tagged`                | A user or integration adds a tag to a call.                                                                                                              |

### Conversation intelligence events

<Callout icon="🚧" theme="warn">
  Some of these events may require the AI Assist add-on. See the <Anchor target="_blank" href="https://developers.aircall.io/api-references/#conversation-intelligence">Conversation Intelligence API reference</Anchor> for details.
</Callout>

| Event                   | When it fires                                         |
| :---------------------- | :---------------------------------------------------- |
| `transcription.created` | A call transcription is available                     |
| `summary.created`       | A call summary is available                           |
| `topics.created`        | Key topics are available for a call                   |
| `action_item.created`   | AI adds an action item based on ongoing conversation. |

<br />