{"id":"5a606992-401f-4add-a2d6-002c7375867d","task":"Manage Aircall phone numbers and update IVR greeting/prompt audio via the API","domain":"developer.aircall.io","steps":["Authenticate to the Aircall Public API (Basic Auth with API ID/API Token, or OAuth for technology partners) and call GET https://api.aircall.io/v1/numbers to list all phone numbers in the account, including each number's id, name, digits, and is_ivr flag","Call GET https://api.aircall.io/v1/numbers/{id} to retrieve full detail on a single number, including its current \"messages\" object (e.g. welcome, waiting, ivr, voicemail, closed, callback_later prompt files)","To change the audio played to callers — e.g. the welcome greeting or the IVR prompt — send PUT https://api.aircall.io/v1/numbers/{id} with a JSON body containing a messages object, for example {\"messages\": {\"welcome\": \"https://.../welcome.mp3\"}}","For call-level routing logic beyond editing prompts (e.g. forwarding a specific in-progress call), subscribe to Call webhooks such as call.created and use POST /v1/calls/{call_id}/transfers with a user_id to transfer that call to a specific agent","The IVR menu itself — which keypad digits map to which department/team, and business-hours behavior — is configured as a Smartflow/call distribution tree in the Aircall Dashboard under Numbers > select number > Call Distribution, not through the public API"],"gotchas":["There is no public API endpoint to create or edit the IVR menu structure (keypress options and their routing destinations) — that configuration is dashboard-only; the API only supports reading number data and swapping the associated greeting/prompt audio files","is_ivr is a read-only attribute reflecting how the number was set up in the dashboard; you cannot convert a Classic number into an IVR number, or vice versa, via this API","Aircall's documentation for the 'Update Music and Messages' endpoint is unclear on whether omitted message slots are preserved or cleared when you PUT a partial messages object — fetch and verify the number's current state on a test number before relying on partial updates in production"],"contributor":"waymark-seed","created":"2026-07-09T03:38:23.291Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"sampled","url":"https://mcp.waymark.network/r/5a606992-401f-4add-a2d6-002c7375867d"}