Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
29 changes: 28 additions & 1 deletion src/provider-guides/aircall.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,15 +4,30 @@ slug: "aircall"
excerpt: ""
hidden: false
createdAt: "Mon Jun 24 2024 08:32:49 GMT+0000 (Coordinated Universal Time)"
updatedAt: "Thu Aug 08 2024 22:39:27 GMT+0000 (Coordinated Universal Time)"
updatedAt: "Sun Dec 28 2025 18:00:00 GMT+0000 (Coordinated Universal Time)"
---

## What's Supported

### Supported Actions

This connector supports:

- [Read Actions](/read-actions).
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You should mention if the incremental read is supported so people know. Many provider guides mention this information.

- [Write Actions](/write-actions).
- [Proxy Actions](/proxy-actions), using the base URL `https://api.aircall.io`.

### Supported Objects

The Aircall connector supports writing to and reading from the following objects:

- [Calls](https://developer.aircall.io/api-references/#calls) (`calls`)
- [Users](https://developer.aircall.io/api-references/#users) (`users`)
- [Contacts](https://developer.aircall.io/api-references/#contacts) (`contacts`)
- [Numbers](https://developer.aircall.io/api-references/#numbers) (`numbers`)
- [Teams](https://developer.aircall.io/api-references/#teams) (`teams`)
- [Tags](https://developer.aircall.io/api-references/#tags) (`tags`)

## Before You Get Started

To integrate **Aircall** with **Ampersand**, you must register an **Aircall OAuth2** application. To do this, contact `marketplace@aircall.io` and provide the following details:
Expand Down Expand Up @@ -44,3 +59,15 @@ Once you have your Aircall app set up and registered, you can proceed to connect
![Dashboard](/images/provider-guides/053beed-aircall.gif)

7. Click **Save Changes**.

## Using the connector

To start integrating with Aircall:

- Create a manifest file like the [example](https://github.com/amp-labs/samples/blob/main/aircall/amp.yaml).
- Deploy it using the [amp CLI](/cli/overview).
- Embed the [InstallIntegration](/embeddable-ui-components#install-integration) UI component.
- Start using the connector!
- If your integration has [Read Actions](/read-actions), you'll start getting webhook messages.
- If your integration has [Write Actions](/write-actions), you can start making API calls to our Write API.
- If your integration has [Proxy Actions](/proxy-actions), you can start making Proxy API calls.