Aircall

Overview

Connect your users to Aircall for cloud-based phone systems, call management, and team communication.

Property	Value
Provider ID	aircall
Category	Communication
PKCE	Supported
Token refresh	Automatic
Redirect URI	Shown in Developer Portal

Step 1: Create an Aircall OAuth App

Go to the Aircall Dashboard

Navigate to Aircall Dashboard and sign in.

Build your own integration

Click Build your own integration.

Configure the application

Enter the application name and description. Add the Alter callback URL (from the Developer Portal) to the Redirect URI field.

Get credentials

Copy the Client ID and Client Secret.

Warning

Never share your Client Secret publicly. Store it securely and only enter it in the Alter Vault Developer Portal.

Step 2: Add to Alter Vault

Open the Developer Portal

Go to portal.alterauth.com and navigate to the application.

Add Aircall provider

Go to OAuth Providers > Add Provider > Aircall.

Enter credentials

• Client ID: Paste your Aircall Client ID
• Client Secret: Paste your Aircall Client Secret

Select scopes

Choose the scopes the application needs.

Save

Click Save. The provider is now active.

Available Scopes

Scope	Description
public_api	Full access to the Aircall public API (calls, contacts, users, etc.)

Note

The public_api scope is required for API access and is selected by default.

Notes

• Aircall requires the public_api scope for all API access. This scope covers calls, contacts, users, and other resources.
• See the Aircall API documentation for more details on available endpoints.

Policy-cataloged operations

Alter policy rules can target these attested operations and families for operation-level and parameter-aware controls.

Operation ID	Families	Method	Provider path
calls/comment	send	POST	/v1/calls/{id}/comments
webhooks/delete	admin, delete	DELETE	/v1/webhooks/{webhook_id}
webhooks/create	admin, write	POST	/v1/webhooks
calls/tags	write	POST	/v1/calls/{id}/tags
contacts/create	write	POST	/v1/contacts
calls/get	read	GET	/v1/calls/{id}
calls/list	read	GET	/v1/calls
calls/transcription	read	GET	/v1/calls/{call_id}/transcription
company/get	read	GET	/v1/company
contacts/get	read	GET	/v1/contacts/{id}
contacts/list	read	GET	/v1/contacts
contacts/search	read	GET	/v1/contacts/search
integrations/me	read	GET	/v1/integrations/me
numbers/get	read	GET	/v1/numbers/{id}
numbers/list	read	GET	/v1/numbers
tags/list	read	GET	/v1/tags
teams/get	read	GET	/v1/teams/{id}
teams/list	read	GET	/v1/teams
users/get	read	GET	/v1/users/{id}
users/list	read	GET	/v1/users
webhooks/list	read	GET	/v1/webhooks