> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Aircall

> Aircall is a cloud-based phone and call-center platform. This toolkit manages users, teams, phone numbers, calls, contacts, and tags on a single Aircall company account via the Public API.

![Aircall logo](https://mintcdn.com/composio-preview/qzegrvAapILigeDI/images/toolkits/aircall.svg?fit=max\&auto=format\&n=qzegrvAapILigeDI\&q=85\&s=f495b4321a03f9eaf7219f924dac6986)

* **Category:** communication
* **Auth:** OAUTH2, BASIC
* **Composio-managed OAuth available?** Yes
* **Tools:** 48
* **Triggers:** 0
* **Slug:** `AIRCALL`
* **Version:** 20261101\_00

## Tools

> [accordion] Add Contact Method
>
> **Slug:** `AIRCALL_ADD_CONTACT_METHOD`
>
> Add a phone number or an email address to an existing Aircall contact. Set method\_type='phone' to add a phone number or method\_type='email' to add an email address. The value and any supplied label must be nonblank, but this tool does not impose E.164 or strict email formatting. If the label is omitted, Aircall defaults it to 'Main'. Use when a contact already exists and needs another way to be reached; not for creating the contact itself (AIRCALL\_CREATE\_CONTACT), and not for changing a method that is already on the contact (AIRCALL\_UPDATE\_CONTACT\_METHOD). Returns the created method as 'contact\_method' (\{id, method\_type, label, value}) — keep its id to update or delete it later.
>
> #### Input Parameters
>
> **label** `string`
>
> Optional label for the method. For a phone: 'Work', 'Mobile', 'Home'. For an email: 'Work', 'Personal'. If omitted, Aircall defaults the label to 'Main'.
>
> **value** `string` *required*
>
> Nonblank phone number or email value. Aircall accepts and normalizes multiple phone formats and stores any email format.
>
> **contact\_id** `integer` *required*
>
> Numeric id of the contact to add the method to.
>
> **method\_type** `string ("email" | "phone")` *required*
>
> Which kind of contact method to add: 'phone' for a phone number, 'email' for an email address. This selects the Aircall endpoint.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add User to Team
>
> **Slug:** `AIRCALL_ADD_USER_TO_TEAM`
>
> Add a User to a Team (membership change). Returns the updated team.
>
> #### Input Parameters
>
> **team\_id** `integer` *required*
>
> Team numeric id.
>
> **user\_id** `integer` *required*
>
> Numeric id of the user to add to the team.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add Comment to Call
>
> **Slug:** `AIRCALL_COMMENT_CALL`
>
> Add a comment or note to a call. A call can have at most five comments, and once posted a comment cannot be updated or deleted.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> Numeric id of the call to comment on.
>
> **content** `string` *required*
>
> Comment text to attach to the call (emojis are stripped by Aircall).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Contact
>
> **Slug:** `AIRCALL_CREATE_CONTACT`
>
> Create a shared Aircall contact. Use when adding someone to the shared address book; not for editing an existing one (AIRCALL\_UPDATE\_CONTACT), and not for attaching a phone number or email address to a contact that already exists — that is AIRCALL\_ADD\_CONTACT\_METHOD with method\_type='phone' or method\_type='email'. At least one phone\_numbers\[] entry is required (1-20); emails\[] is optional (max 20). Aircall rejects a name-only contact AND an email-only contact with HTTP 400.
>
> #### Input Parameters
>
> **emails** `array`
>
> Optional email addresses to attach, each \{label, value}; at most 20. Emails alone are not sufficient — phone\_numbers is still required.
>
> **last\_name** `string`
>
> Contact last name.
>
> **first\_name** `string`
>
> Contact first name.
>
> **information** `string`
>
> Free-text note about the contact.
>
> **company\_name** `string`
>
> Company name.
>
> **phone\_numbers** `array` *required*
>
> Required. Phone numbers to attach, each with nonblank \{label, value}; 1-20 entries. Aircall rejects a create with no phone\_numbers (HTTP 400) even when emails are supplied.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Tag
>
> **Slug:** `AIRCALL_CREATE_TAG`
>
> Create a Tag. name must be unique per company; color is a hex string (e.g. #00B388). Aircall does not accept a mutable description field.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Tag name (unique per company).
>
> **color** `string` *required*
>
> Tag color as a hex string, e.g. '#00B388'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Team
>
> **Slug:** `AIRCALL_CREATE_TEAM`
>
> Create a new Team. Requires a name.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Unique nonblank team name, fewer than 64 characters.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create User
>
> **Slug:** `AIRCALL_CREATE_USER`
>
> Create an Aircall user and send them a real invitation email, consuming a licensed seat. Use when adding a new teammate to the account; not for changing someone who already exists (AIRCALL\_UPDATE\_USER). Requires email, first\_name and last\_name. role\_ids takes role NAME strings, one of owner, supervisor, admin or agent, not numeric ids.
>
> #### Input Parameters
>
> **email** `string` *required*
>
> Email address for the new user; the invite email is sent here.
>
> **role\_ids** `array`
>
> Optional roles to assign to the new user. Aircall documents this as an array of role NAME strings, not numeric ids: owner, supervisor, admin, or agent. Omit to let Aircall apply its documented default of agent.
>
> **last\_name** `string` *required*
>
> The new user's nonblank last name.
>
> **first\_name** `string` *required*
>
> The new user's nonblank first name.
>
> **wrap\_up\_time** `integer`
>
> Optional number of seconds of wrap-up time after a call. Aircall documents a default of 0 seconds, and that this applies only to a user whose role\_ids include agent.
>
> **inviter\_user\_id** `integer`
>
> Optional id of the existing user recorded as having invited this one. On V2, this value is ignored when the inviter is not an admin.
>
> **availability\_status** `string ("available" | "custom" | "unavailable")`
>
> Optional starting availability for the new user: available, custom, or unavailable. Omit to let Aircall apply its documented default of available.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Webhook
>
> **Slug:** `AIRCALL_CREATE_WEBHOOK`
>
> Create an Aircall webhook targeting a public HTTPS URL. Select one or more events, or explicitly set subscribe\_to\_all\_events=true; omission never silently subscribes the destination to every company event. Aircall permits at most 100 webhooks per company.
>
> #### Input Parameters
>
> **url** `string` *required*
>
> Public HTTPS endpoint that will receive Aircall events.
>
> **events** `array`
>
> Events from Aircall's documented webhook event set. Required unless subscribe\_to\_all\_events=true.
>
> **custom\_name** `string`
>
> Optional webhook display name.
>
> **subscribe\_to\_all\_events** `boolean`
>
> Set true only when intentionally subscribing to every Aircall event. Aircall represents this on the wire as an empty events array.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Call Media
>
> **Slug:** `AIRCALL_DELETE_CALL_MEDIA`
>
> Request permanent deletion of a Call's audio recording or voicemail, for compliance or data governance. Set media\_type='recording' or media\_type='voicemail'; a call may have one, both, or neither. The call record is retained, but deleting a recording on an AI Assist/Pro account also permanently removes its transcription and AI insights. Use when an audio artefact and its derived AI data must be purged; not for reading call details (AIRCALL\_GET\_CALL). Once processed, deletion is irreversible. A successful response means Aircall accepted the request, not that deletion is complete: recordings take 10-15 minutes and voicemails up to 1 minute, and existing download URLs may work during propagation. A recording can arrive up to 24 hours after the call, so retry later when it is not present yet.
>
> #### Input Parameters
>
> **call\_id** `integer` *required*
>
> Numeric id of the call whose media to delete.
>
> **media\_type** `string ("recording" | "voicemail")` *required*
>
> Which media artefact to remove: 'recording' for the call's audio recording, or 'voicemail' for the voicemail message left on it. A call may have one, both, or neither. Recording deletion also permanently removes transcription and AI insights on AI Assist/Pro accounts.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Contact
>
> **Slug:** `AIRCALL_DELETE_CONTACT`
>
> Permanently delete a shared contact by ID, including its phone numbers and email addresses. The tool returns a success confirmation when deletion succeeds.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> Contact numeric id to delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Contact Method
>
> **Slug:** `AIRCALL_DELETE_CONTACT_METHOD`
>
> Permanently remove one phone number or email address from an Aircall contact. Set method\_type='phone' or method\_type='email' to say which kind method\_id refers to. Use when a contact should no longer be reachable that way; not for deleting the whole contact (AIRCALL\_DELETE\_CONTACT), and not for correcting a method's value or label (AIRCALL\_UPDATE\_CONTACT\_METHOD). IRREVERSIBLE: the method is gone and re-adding it mints a new id. Returns \{success: true} on HTTP 204.
>
> #### Input Parameters
>
> **method\_id** `integer` *required*
>
> Id of the phone or email entry to remove. Get it from the contact's phone\_numbers\[] / emails\[] via AIRCALL\_GET\_CONTACT, or from the `id` returned by AIRCALL\_ADD\_CONTACT\_METHOD.
>
> **contact\_id** `integer` *required*
>
> Numeric id of the contact that owns the method.
>
> **method\_type** `string ("email" | "phone")` *required*
>
> Which kind of contact method `method_id` refers to: 'phone' for a phone number, 'email' for an email address. This selects the Aircall endpoint, so it must match the id — a phone id with method\_type='email' will 404.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Tag
>
> **Slug:** `AIRCALL_DELETE_TAG`
>
> Delete a Tag by id, removing it from Calls. The tool returns a success confirmation.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> Tag numeric id to delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Team
>
> **Slug:** `AIRCALL_DELETE_TEAM`
>
> Delete a Team by id, removing it from Numbers' call distribution without deleting its users. The tool returns a success confirmation.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> Team numeric id to delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete User
>
> **Slug:** `AIRCALL_DELETE_USER`
>
> Permanently delete a user and their associated data, which cannot be recovered. Deletion is asynchronous and triggers a user.deleted webhook; the tool returns a success confirmation with the requested user ID.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> Numeric id of the user to delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Webhook
>
> **Slug:** `AIRCALL_DELETE_WEBHOOK`
>
> Permanently delete an accessible Aircall webhook, stopping delivery and losing its configuration. With OAuth, access is limited to the webhook linked to the token; Basic Auth accesses webhooks created through the dashboard and Basic Auth API requests.
>
> #### Input Parameters
>
> **webhook\_id** `string` *required*
>
> UUID of the webhook to delete, or its legacy numeric Aircall id.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Call
>
> **Slug:** `AIRCALL_GET_CALL`
>
> Retrieve a single Call by id, with optional contact / short-url / timeline enrichment via the fetch\_\* flags.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> Call numeric id.
>
> **fetch\_contact** `boolean`
>
> Include the matched contact object.
>
> **fetch\_aiva\_conv** `boolean`
>
> Include AI Voice Agent segments in call.ai\_voice\_agents.
>
> **fetch\_short\_urls** `boolean`
>
> Include shortened asset URLs.
>
> **fetch\_call\_timeline** `boolean`
>
> Include the per-call event timeline.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Company
>
> **Slug:** `AIRCALL_GET_COMPANY`
>
> Retrieve information about the connected Aircall company (name, users\_count, numbers\_count). This is the best true auth-verify endpoint: a 200 confirms the Basic Auth credentials are valid.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Contact
>
> **Slug:** `AIRCALL_GET_CONTACT`
>
> Retrieve a single shared Contact by id, with its nested phone\_numbers\[] and emails\[]. NOTE: contact created\_at/updated\_at are UNIX-epoch INTEGERS.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> Contact numeric id.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Number
>
> **Slug:** `AIRCALL_GET_NUMBER`
>
> Retrieve a single Aircall phone Number by its numeric id.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> Numeric id of the Aircall number to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Number Registration Status
>
> **Slug:** `AIRCALL_GET_NUMBER_REGISTRATION_STATUS`
>
> Check whether an Aircall phone number is registered for compliance (10DLC or other regulatory registration) by reading the `status` field. Use for regulatory registration state only; not for the number's name, availability or Music & Messages (AIRCALL\_GET\_NUMBER).
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> Numeric id of the Aircall number whose registration status to fetch.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Tag
>
> **Slug:** `AIRCALL_GET_TAG`
>
> Retrieve a single Tag by id.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> Tag numeric id.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Team
>
> **Slug:** `AIRCALL_GET_TEAM`
>
> Retrieve a single Team by id, including its member users.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> Team numeric id.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get User
>
> **Slug:** `AIRCALL_GET_USER`
>
> Retrieve one Aircall user by numeric id or by email address. Both work in the id field. Use when you already have the id or email; not for browsing the roster (AIRCALL\_LIST\_USERS). The user's assigned phone numbers are not included. Get them from AIRCALL\_LIST\_USER\_NUMBERS.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> User numeric id OR email address — both are accepted in the path. The numeric id may be passed as an int (as returned by AIRCALL\_LIST\_USERS) or a string.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get User Availability
>
> **Slug:** `AIRCALL_GET_USER_AVAILABILITY`
>
> Check the current availability of one User. Returns availability ∈ available | offline | do\_not\_disturb | in\_call | after\_call\_work.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> User numeric id whose availability to check.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Webhook
>
> **Slug:** `AIRCALL_GET_WEBHOOK`
>
> Retrieve an accessible Aircall webhook by UUID or legacy numeric ID. With OAuth, access is limited to the webhook linked to the token; Basic Auth accesses webhooks created through the dashboard and Basic Auth API requests.
>
> #### Input Parameters
>
> **webhook\_id** `string` *required*
>
> Webhook UUID returned by LIST\_WEBHOOKS or CREATE\_WEBHOOK, or the legacy numeric webhook id that Aircall still accepts.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Calls
>
> **Slug:** `AIRCALL_LIST_CALLS`
>
> List the account's calls in chronological order, covering about 6 months of history and at most 10,000 items via pagination. Window past that with the `from` UNIX timestamp. Use for plain date-ordered browsing of call activity; not when filtering by direction, user, phone number or tag, which is what AIRCALL\_SEARCH\_CALLS is for. An account with no calls returns an empty list with HTTP 200, never 404.
>
> #### Input Parameters
>
> **to** `integer`
>
> Only calls created at/before this UNIX timestamp (seconds).
>
> **from** `integer`
>
> Only calls created at/after this UNIX timestamp (seconds). Use to page past the 10,000-item cap.
>
> **page** `integer`
>
> 1-based page number.
>
> **order** `string ("asc" | "desc")`
>
> Sort by created\_at: 'asc' (default) or 'desc'.
>
> **cursor** `string`
>
> Continuation cursor from a prior response's next\_cursor. Omit for the first page.
>
> **per\_page** `integer`
>
> Items per page (1-50; Mercury default 10).
>
> **fetch\_contact** `boolean`
>
> Include the matched contact object on each call.
>
> **fetch\_aiva\_conv** `boolean`
>
> Include AI Voice Agent segments in each call.
>
> **fetch\_short\_urls** `boolean`
>
> Include shortened asset URLs.
>
> **fetch\_call\_timeline** `boolean`
>
> Include the per-call event timeline.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Contacts
>
> **Slug:** `AIRCALL_LIST_CONTACTS`
>
> List shared contacts with their phone numbers and email addresses, with contact timestamps as UNIX-epoch integers. Results are paginated, with up to 10,000 items accessible via pagination; use the from timestamp to window past that limit.
>
> #### Input Parameters
>
> **to** `integer`
>
> Only contacts created at/before this UNIX timestamp (seconds).
>
> **from** `integer`
>
> Only contacts created at/after this UNIX timestamp (seconds).
>
> **page** `integer`
>
> 1-based page number to fetch (default 1).
>
> **order** `string ("asc" | "desc")`
>
> Sort order: 'asc' (default) or 'desc'.
>
> **cursor** `string`
>
> Continuation cursor from a prior response's next\_cursor. Omit for the first page.
>
> **order\_by** `string ("created_at" | "updated_at")`
>
> Field to sort by: 'created\_at' (default) or 'updated\_at'.
>
> **per\_page** `integer`
>
> Items per page (1-50; Mercury default 10).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Numbers
>
> **Slug:** `AIRCALL_LIST_NUMBERS`
>
> List all Aircall phone Numbers in the account. Each number includes id, digits, name, country, availability and a `messages` object of audio URLs. Paginated via page/per\_page; to page, pass the response's next\_cursor back as cursor (has\_more signals whether more pages remain).
>
> #### Input Parameters
>
> **to** `integer`
>
> Only numbers created at/before this UNIX timestamp (seconds).
>
> **from** `integer`
>
> Only numbers created at/after this UNIX timestamp (seconds).
>
> **page** `integer`
>
> 1-based page number to fetch (default 1).
>
> **order** `string ("asc" | "desc")`
>
> Sort by created\_at: 'asc' or 'desc'.
>
> **cursor** `string`
>
> Continuation cursor from a prior response's next\_cursor. Omit for the first page.
>
> **per\_page** `integer`
>
> Items per page (1-50; Mercury default 10).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Tags
>
> **Slug:** `AIRCALL_LIST_TAGS`
>
> List all Tags in the account. Each tag = \{id, name, color (hex), description}. Paginated via page/per\_page; to page, pass the response's next\_cursor back as cursor (has\_more signals whether more pages remain).
>
> #### Input Parameters
>
> **page** `integer`
>
> 1-based page number to fetch (default 1).
>
> **cursor** `string`
>
> Continuation cursor from a prior response's next\_cursor. Omit for the first page.
>
> **per\_page** `integer`
>
> Items per page (1-50; Mercury default 10).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Teams
>
> **Slug:** `AIRCALL_LIST_TEAMS`
>
> List all Teams in the account. Each team embeds its member users (nested user objects). Paginated via page/per\_page; to page, pass the response's next\_cursor back as cursor (has\_more signals whether more pages remain).
>
> #### Input Parameters
>
> **page** `integer`
>
> 1-based page number to fetch (default 1).
>
> **order** `string ("asc" | "desc")`
>
> Sort by created\_at: 'asc' or 'desc'.
>
> **cursor** `string`
>
> Continuation cursor from a prior response's next\_cursor. Omit for the first page.
>
> **per\_page** `integer`
>
> Items per page (1-50; Mercury default 10).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List User Numbers (V2)
>
> **Slug:** `AIRCALL_LIST_USER_NUMBERS`
>
> List all Aircall Numbers assigned to a specific User (V2, paginated). Returns one page plus a next\_cursor to fetch the next. The number ids feed AIRCALL\_START\_OUTBOUND\_CALL. Targets the /v2 API.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> Numeric id of the user whose numbers to list — pass the int as returned by AIRCALL\_LIST\_USERS (a numeric string is also accepted).
>
> **page** `integer`
>
> 1-based page number for the first request.
>
> **order** `string ("asc" | "desc")`
>
> Sort by created\_at: 'asc' or 'desc'.
>
> **cursor** `string`
>
> Opaque pagination cursor from a prior response's next\_cursor. Omit for the first page.
>
> **per\_page** `integer`
>
> Items per page (1-50; Mercury default 10).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Users
>
> **Slug:** `AIRCALL_LIST_USERS`
>
> List the users in the Aircall account, one page at a time with a next\_cursor to continue. Use when you need user ids, names, emails, availability or default\_number\_id; not for a single known user (AIRCALL\_GET\_USER), and not for the phone numbers a user can call from (AIRCALL\_LIST\_USER\_NUMBERS).
>
> #### Input Parameters
>
> **to** `integer`
>
> Only return users created at/before this UNIX timestamp (seconds). The legacy name `created_before` is still accepted.
>
> **from** `integer`
>
> Only return users created at/after this UNIX timestamp (seconds). Sent as the `from` query param. The legacy name `created_after` is still accepted.
>
> **page** `integer`
>
> 1-based page number for the first request.
>
> **order** `string ("asc" | "desc")`
>
> Sort by created\_at: 'asc' (default) or 'desc'.
>
> **cursor** `string`
>
> Continuation cursor from a previous response's next\_cursor. Omit for the first page; pass the returned value back verbatim to fetch the next page.
>
> **per\_page** `integer`
>
> Number of users per page (1-50; Mercury default 10).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Users Availability
>
> **Slug:** `AIRCALL_LIST_USERS_AVAILABILITY`
>
> List the detailed availability of all Users (whether each user is available/offline/on a call, etc.). Paginated via page/per\_page; to page, pass the response's next\_cursor back as cursor (has\_more signals whether more pages remain).
>
> #### Input Parameters
>
> **to** `integer`
>
> Only include users created at/before this UNIX timestamp (seconds).
>
> **from** `integer`
>
> Only include users created at/after this UNIX timestamp (seconds).
>
> **page** `integer`
>
> 1-based page number to fetch (default 1).
>
> **order** `string ("asc" | "desc")`
>
> Sort by created\_at: 'asc' or 'desc'.
>
> **cursor** `string`
>
> Continuation cursor from a prior response's next\_cursor. Omit for the first page.
>
> **per\_page** `integer`
>
> Items per page (1-50; Mercury default 10).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Webhooks
>
> **Slug:** `AIRCALL_LIST_WEBHOOKS`
>
> List one page of webhook subscriptions, with OAuth limited to the webhook linked to the token and Basic Auth accessing dashboard- and Basic Auth-created webhooks. Pass a non-null next\_cursor to retrieve the next page and discover webhook UUIDs.
>
> #### Input Parameters
>
> **page** `integer`
>
> 1-based page number.
>
> **order** `string ("asc" | "desc")`
>
> Order by created\_at: 'asc' or 'desc'.
>
> **cursor** `string`
>
> Continuation cursor from next\_cursor. Omit for the first page.
>
> **per\_page** `integer`
>
> Items per page (1-50, default 10).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Publish Call Insight Card
>
> **Slug:** `AIRCALL_PUBLISH_CALL_INSIGHT_CARD`
>
> Display contextual title, short text, links, or Aircall user details to the agent handling an ongoing call. Cards are ephemeral: only ongoing calls show them and Aircall does not store them after the call. The JSON payload must be strictly less than 10KB.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> Numeric ID of the ongoing Aircall call.
>
> **contents** `array` *required*
>
> Lines displayed to the agent: title, shortText, and/or user entries.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Remove User from Team
>
> **Slug:** `AIRCALL_REMOVE_USER_FROM_TEAM`
>
> Remove a User from a Team (membership change). Returns the updated team when Aircall sends HTTP 200, or a success confirmation for an empty HTTP 204. Does not delete the user.
>
> #### Input Parameters
>
> **team\_id** `integer` *required*
>
> Team numeric id.
>
> **user\_id** `integer` *required*
>
> Numeric id of the user to remove from the team.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Calls
>
> **Slug:** `AIRCALL_SEARCH_CALLS`
>
> Search calls by direction, user, phone number or tag IDs, optionally narrowed by a date window; at least one of those filters is required. For transferred calls, phone-number filtering matches the destination rather than the original number.
>
> #### Input Parameters
>
> **to** `integer`
>
> Only calls created at/before this UNIX timestamp (seconds).
>
> **from** `integer`
>
> Only calls created at/after this UNIX timestamp (seconds).
>
> **page** `integer`
>
> 1-based page number.
>
> **tags** `array`
>
> Tag ids to filter by, AND-matched (serialized as repeated ?tags= params).
>
> **order** `string ("asc" | "desc")`
>
> Sort by created\_at: 'asc' or 'desc'.
>
> **cursor** `string`
>
> Continuation cursor from a prior response's next\_cursor. Omit for the first page.
>
> **user\_id** `integer`
>
> Filter by the id of the user who handled the call.
>
> **per\_page** `integer`
>
> Items per page (1-50; Mercury default 10).
>
> **direction** `string ("inbound" | "outbound")`
>
> Filter by call direction: 'inbound' or 'outbound'.
>
> **phone\_number** `string`
>
> Filter by external phone number.
>
> **fetch\_contact** `boolean`
>
> Include the matched contact object on each call.
>
> **fetch\_aiva\_conv** `boolean`
>
> Include AI Voice Agent segments in each call.
>
> **fetch\_short\_urls** `boolean`
>
> Include shortened asset URLs.
>
> **fetch\_call\_timeline** `boolean`
>
> Include the per-call event timeline.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Contacts
>
> **Slug:** `AIRCALL_SEARCH_CONTACTS`
>
> Search shared Contacts by phone number and/or email, optionally within a date window; third-party integration contacts are inaccessible and pagination retrieves up to 10,000 contacts. Pass next\_cursor as cursor while has\_more is true; contact timestamps are UNIX-epoch integers.
>
> #### Input Parameters
>
> **to** `integer`
>
> Only contacts created at/before this UNIX timestamp (seconds).
>
> **from** `integer`
>
> Only contacts created at/after this UNIX timestamp (seconds).
>
> **page** `integer`
>
> 1-based page number to fetch (default 1).
>
> **email** `string`
>
> Email address to match.
>
> **order** `string ("asc" | "desc")`
>
> Sort order: 'asc' or 'desc'.
>
> **cursor** `string`
>
> Continuation cursor from a prior response's next\_cursor. Omit for the first page.
>
> **order\_by** `string ("created_at" | "updated_at")`
>
> Field to sort by: 'created\_at' or 'updated\_at'.
>
> **per\_page** `integer`
>
> Items per page (1-50; Mercury default 10).
>
> **phone\_number** `string`
>
> Phone number to match (E.164).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Set Call Recording State
>
> **Slug:** `AIRCALL_SET_CALL_RECORDING_STATE`
>
> Pause or resume recording on an ongoing Aircall call. This is destructive: audio from a paused interval is never recorded and cannot be recovered by resuming later. The call must still be live and live recording must be enabled on its Aircall number.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> Numeric ID of an ongoing Aircall call.
>
> **state** `string ("paused" | "recording")` *required*
>
> Desired live-recording state: paused or recording (resumed).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Start Outbound Call
>
> **Slug:** `AIRCALL_START_OUTBOUND_CALL`
>
> Place a real, billable outbound phone call from an Aircall user's desktop Workspace to an external number. Use when a specific user should dial someone now. Requires the user's desktop Workspace app to be open, the user to be available, and a number\_id the user owns, from AIRCALL\_LIST\_USER\_NUMBERS. Returns acceptance only. No call id comes back and the call may still fail to connect; locate it afterwards with AIRCALL\_SEARCH\_CALLS. Calling again places a second call.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> Id of the user who will place the call.
>
> **to** `string` *required*
>
> Destination phone number in E.164 format (e.g. +14155550123).
>
> **number\_id** `integer` *required*
>
> Id of the Aircall number to call from (must belong to the user).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Tag Call
>
> **Slug:** `AIRCALL_TAG_CALL`
>
> Tag a Call with one or more existing Tag ids (create tags first with AIRCALL\_CREATE\_TAG). Returns success on HTTP 201.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> Numeric id of the call to tag.
>
> **tags** `array` *required*
>
> Array of EXISTING Tag ids to apply to the call. Get/create tag ids via AIRCALL\_LIST\_TAGS / AIRCALL\_CREATE\_TAG.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Transfer Call
>
> **Slug:** `AIRCALL_TRANSFER_CALL`
>
> Cold-transfer a live call to one user, team, or external phone number, with an optional team dispatching strategy; external-number transfers work only for unanswered inbound calls. A successful request indicates acceptance, but the transfer may fail to connect.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> Numeric id of the live (in-progress) call to transfer.
>
> **number** `string`
>
> External phone number to transfer an unanswered inbound call to, in E.164 format. Supply exactly one of user\_id, team\_id, or number.
>
> **team\_id** `integer`
>
> Id of the Aircall team to transfer the call to. Supply exactly one of user\_id, team\_id, or number.
>
> **user\_id** `integer`
>
> Id of the Aircall user to transfer the call to. Supply exactly one of user\_id, team\_id, or number.
>
> **dispatching\_strategy** `string ("random" | "simultaneous" | "longest_idle")`
>
> Team-only dispatching strategy. Defaults to 'simultaneous' when team\_id is selected.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Contact
>
> **Slug:** `AIRCALL_UPDATE_CONTACT`
>
> Update a Contact's core fields (first\_name, last\_name, company\_name, information). Phone numbers and emails are edited via the dedicated contact-method tools (AIRCALL\_ADD\_CONTACT\_METHOD / AIRCALL\_UPDATE\_CONTACT\_METHOD / AIRCALL\_DELETE\_CONTACT\_METHOD), not here.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> Contact numeric id to update.
>
> **last\_name** `string`
>
> New last name.
>
> **first\_name** `string`
>
> New first name.
>
> **information** `string`
>
> New free-text note.
>
> **company\_name** `string`
>
> New company name.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Contact Method
>
> **Slug:** `AIRCALL_UPDATE_CONTACT_METHOD`
>
> Update one phone number or email address that is already on an Aircall contact. Set method\_type='phone' or method\_type='email' to say which kind method\_id refers to, and always send a nonblank value — Aircall requires it on every update even when only the label changes. Use when changing a method that already exists; not for adding a new one (AIRCALL\_ADD\_CONTACT\_METHOD), and not for removing one (AIRCALL\_DELETE\_CONTACT\_METHOD). Answers HTTP 202 Accepted and returns the updated method as 'contact\_method'.
>
> #### Input Parameters
>
> **label** `string`
>
> New label for the method, e.g. 'Work', 'Mobile', 'Personal'. Omit to leave the label unchanged.
>
> **value** `string` *required*
>
> The nonblank phone number or email value. Aircall does not require E.164 or strict email syntax. REQUIRED on every update — Aircall rejects an update that omits it, even when only the label is changing, so re-send the current value if you are not changing it.
>
> **method\_id** `integer` *required*
>
> Id of the phone or email entry to update. Get it from the `id` returned by AIRCALL\_ADD\_CONTACT\_METHOD, or from the contact's phone\_numbers\[] / emails\[] via AIRCALL\_GET\_CONTACT.
>
> **contact\_id** `integer` *required*
>
> Numeric id of the contact that owns the method.
>
> **method\_type** `string ("email" | "phone")` *required*
>
> Which kind of contact method `method_id` refers to: 'phone' for a phone number, 'email' for an email address. This selects the Aircall endpoint, so it must match the id — a phone id with method\_type='email' will 404.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Number
>
> **Slug:** `AIRCALL_UPDATE_NUMBER`
>
> Update an Aircall Number's name, availability status, recording, routing priority, or Music & Messages URLs. Changes can affect live call routing, recording and caller audio; previous values are not automatically restored, and Aircall does not document whether omitted fields or message slots are preserved.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> Numeric id of the Aircall number to update.
>
> **name** `string`
>
> New display name for the number.
>
> **messages** `object`
>
> Documented Music & Messages slots: welcome, waiting, ivr, voicemail, closed, callback\_later, unanswered\_call, after\_hours, and ringing\_tone. Each supplied value must be a valid public HTTP(S) URL. Aircall does not document whether a partially-supplied body preserves unlisted slots, so capture the current values with AIRCALL\_GET\_NUMBER first if you need to revert.
>
> **priority** `integer ("0" | "1")`
>
> Routing priority: 0 for no priority, 1 for top priority, or null to clear it.
>
> **availability\_status** `string ("open" | "custom" | "closed")`
>
> Update the first Time Rule widget's availability status.
>
> **live\_recording\_activated** `boolean`
>
> Enable or disable inbound and outbound call recording for this number.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Tag
>
> **Slug:** `AIRCALL_UPDATE_TAG`
>
> Update a Tag's name and color by id. Both fields are required by this tool, and the name must remain unique.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> Tag numeric id to update.
>
> **name** `string` *required*
>
> Tag name (unique per company).
>
> **color** `string` *required*
>
> Tag color as a hex string, e.g. '#00B388'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update User
>
> **Slug:** `AIRCALL_UPDATE_USER`
>
> Update an existing Aircall user's name, availability\_status, substatus, roles or wrap-up time in place. Use when changing a user who already exists; not for creating one (AIRCALL\_CREATE\_USER), and not for reading their current availability (AIRCALL\_GET\_USER\_AVAILABILITY). substatus applies only when availability\_status is 'unavailable'.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> Numeric id of the user to update.
>
> **role\_ids** `array`
>
> Roles to assign to the user. Aircall documents this as an array of role NAME strings, not numeric ids: owner, supervisor, admin, or agent.
>
> **last\_name** `string`
>
> New last name.
>
> **substatus** `string ("out_for_lunch" | "on_a_break" | "in_training" | "doing_back_office" | "other")`
>
> New availability sub-status. Aircall documents these values as applying when availability\_status is 'unavailable', so this is rejected if the same request explicitly sets availability\_status to 'available' or 'custom'. Sending substatus without availability\_status is allowed — the user may already be unavailable server-side.
>
> **first\_name** `string`
>
> New first name.
>
> **wrap\_up\_time** `integer`
>
> Post-call wrap-up time in seconds.
>
> **availability\_status** `string ("available" | "custom" | "unavailable")`
>
> New availability status: one of available | custom | unavailable.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Webhook
>
> **Slug:** `AIRCALL_UPDATE_WEBHOOK`
>
> Update an accessible Aircall webhook's URL, name, active state, or event subscriptions, using preserve, replace, add, remove, or all modes; preserve is the default. OAuth access is limited to the webhook linked to the token, while Basic Auth accesses dashboard- and Basic Auth-created webhooks.
>
> #### Input Parameters
>
> **url** `string`
>
> New public HTTPS destination URL.
>
> **active** `boolean`
>
> True to reactivate the webhook or false to disable it.
>
> **events** `array`
>
> Event names used by replace/add/remove mode. Omit in preserve/all mode.
>
> **webhook\_id** `string` *required*
>
> UUID of the webhook to update, or its legacy numeric Aircall id.
>
> **custom\_name** `string`
>
> New webhook display name.
>
> **event\_update\_mode** `string ("preserve" | "replace" | "add" | "remove" | "all")`
>
> Explicit event-set intent: preserve leaves events unchanged; replace sets exactly events; add/remove modifies named events; all intentionally subscribes to every event.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
