start_call
Start Outbound Call
Initiate an outbound call on behalf of a user. The user must be available, not currently on a call, and associated with the specified number. Works only on desktop app.
start_call
Initiate an outbound call on behalf of a user. The user must be available, not currently on a call, and associated with the specified number. Works only on desktop app.
get_user
Retrieve detailed information about a specific user including their availability, assigned numbers, timezone, and role details. Optionally check the user's real-time availability status.
manage_call
Perform actions on a call: transfer to a user/team/number, add comments or tags, archive/unarchive, or control recording (pause/resume/delete). One action per request. Acknowledgement does not prove completion. Recording/voicemail deletion is delayed and irreversible; recording deletion also removes AI artifacts. Archive only toggles a legacy flag.
create_insight_card
Display contextual information to agents during an ongoing call. Push custom data such as customer details, CRM links, or account information into the agent's call view. Cards are only visible during the active call and are not stored afterward.
list_contacts
List and search contacts in Aircall. Optionally filter by phone number or email address. Returns contact details including phone numbers, emails, and company information.
manage_user
Create, update, or delete a user in Aircall. When creating, provide email, first name, and last name. When updating, specify only the fields to change. Supports setting availability, roles, and wrap-up time through the documented V1 API, which has announced deprecation. Creation sends an invitation email. Deletion is queued and can destroy associated data.
list_numbers
List all phone numbers associated with the Aircall account. Returns number details including country, timezone, open/closed status, and live recording settings.
send_message
Send a text message from an Aircall phone number. This retained tool does not accept media uploads. The number must be pre-configured for API-based messaging. Messages sent via API are **not** recorded or displayed in the Aircall platform.
list_calls
List and search calls in Aircall. Filter by direction, phone number, user, tag IDs and time range. contactId is retained with guidance because no native filter is documented. Returns call metadata including direction, status, duration, participants, and associated recordings.
list_tags
List all tags available in the Aircall account. Tags are used to categorize and label calls. Use the returned tag IDs to apply tags to calls via the Manage Call tool.
get_call
Retrieve detailed information about a specific call including participants, recording URLs, comments, tags, transfer details, and IVR selections.
manage_team
Create or delete teams, and add or remove users from teams. Teams are used in call distribution for numbers. Retrieve team details with user membership.
list_users
List all users in the Aircall account with their availability status, assigned numbers, and role information. Supports pagination and time-based filtering.
manage_contact
Create, update, or delete a contact in Aircall. Creation requires at least one phone number; names are optional. When updating, specify only the fields to change. Also supports adding, updating, or removing phone numbers and emails on existing contacts.
download_call_media
Prepare a downloadable existing recording or voicemail MP3 from an exact call. Signed URLs expire after one hour; renewal requires the same authorized call/media identity. No new call or recording is created.
get_company
Retrieve the native company summary. OAuth also exposes the current integration and native company ID; Basic authentication does not expose a company ID or person identity.
get_contact
Retrieve an exact shared contact and its native phone/email detail IDs. Discover contact IDs with list_contacts; private contacts are not exposed by this API.
Manage calls, shared contacts, users and teams; discover numbers, tags and company context; send text messages and download existing call audio. Native acceptance and queued lifecycle outcomes remain explicit.
Common questions about connecting Aircall to AI agents with Metorial.