Creates a new Live Call Router from provided data
curl --request POST \
--url https://api.rootly.com/v1/live_call_routers \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/vnd.api+json' \
--data '
{
"data": {
"type": "live_call_routers",
"attributes": {
"kind": "voicemail",
"name": "<string>",
"country_code": "AU",
"phone_type": "local",
"phone_number": "<string>",
"enabled": true,
"voicemail_greeting": "<string>",
"caller_greeting": "<string>",
"waiting_music_url": "https://storage.rootly.com/twilio/voicemail/ClockworkWaltz.mp3",
"sent_to_voicemail_delay": 123,
"should_redirect_to_voicemail_on_no_answer": true,
"escalation_level_delay_in_seconds": 123,
"should_auto_resolve_alert_on_call_end": true,
"alert_urgency_id": "<string>",
"calling_tree_prompt": "<string>",
"paging_targets": [
{
"id": "<string>",
"type": "service",
"alert_urgency_id": "<string>"
}
],
"escalation_policy_trigger_params": {
"id": "<string>",
"type": "service"
}
}
}
}
'{
"data": {
"id": "4b4ded7a-9079-47d4-8a78-85ad0c0dd98a",
"type": "live_call_routers",
"attributes": {
"kind": "voicemail",
"name": "live_call_router-prod",
"country_code": "US",
"phone_type": "toll_free",
"phone_number": "+14155552344",
"voicemail_greeting": "hello",
"slug": "live_call_router-prod",
"enabled": true,
"created_at": "2025-12-05T21:27:23.214-08:00",
"updated_at": "2025-12-05T21:27:23.240-08:00",
"calling_tree_prompt": "Press 1 for service, Press 2 for escalation policy",
"paging_targets": [
{
"id": "447b5884-cae6-443a-89e0-65a2787a251b",
"type": "service",
"alert_urgency_id": "b7454666-45ca-4dad-9b2f-9193cf6ae4a7"
},
{
"id": "a7366441-c4a6-42c6-bbc8-a0f5a62989d6",
"type": "escalation_policy",
"alert_urgency_id": "90a2f11d-9ff4-48bc-9226-f3caa6662916"
}
]
}
}
}Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Show child attributes
live_call_routers Show child attributes
The kind of the live_call_router
voicemail, live The name of the live_call_router
The country code of the live_call_router
AU, CA, DE, NL, NZ, GB, US The phone type of the live_call_router
local, toll_free, mobile You can select a phone number using generate_phone_number API and pass that phone number here to register
Whether the live_call_router is enabled
The voicemail greeting of the live_call_router
The caller greeting message of the live_call_router
The waiting music URL of the live_call_router
https://storage.rootly.com/twilio/voicemail/ClockworkWaltz.mp3, https://storage.rootly.com/twilio/voicemail/ith_brahms-116-4.mp3, https://storage.rootly.com/twilio/voicemail/Mellotroniac_-_Flight_Of_Young_Hearts_Flute.mp3, https://storage.rootly.com/twilio/voicemail/BusyStrings.mp3, https://storage.rootly.com/twilio/voicemail/oldDog_-_endless_goodbye_%28instr.%29.mp3, https://storage.rootly.com/twilio/voicemail/MARKOVICHAMP-Borghestral.mp3, https://storage.rootly.com/twilio/voicemail/ith_chopin-15-2.mp3 The delay (seconds) after which the caller in redirected to voicemail
This prompts the caller to choose voicemail or connect live
This overrides the delay (seconds) in escalation levels
This overrides the delay (seconds) in escalation levels
This is used in escalation paths to determine who to page
The audio instructions callers will hear when they call this number, prompting them to select from available options to route their call
Paging targets that callers can select from when this live call router is configured as a phone tree.
Show child attributes
The ID of paging target
The type of the paging target
service, team, escalation_policy This is used in escalation paths to determine who to page
live_call_router created with multiple notification targets
Show child attributes
Unique ID of the live_call_router
live_call_routers Show child attributes
The name of the live_call_router
Date of creation
Date of last update
The kind of the live_call_router
voicemail, live Whether the live_call_router is enabled
The country code of the live_call_router
AU, CA, DE, NL, NZ, GB, US The phone type of the live_call_router
local, toll_free, mobile You can select a phone number using generate_phone_number API and pass that phone number here to register
The voicemail greeting of the live_call_router
The caller greeting message of the live_call_router
The waiting music URL of the live_call_router
https://storage.rootly.com/twilio/voicemail/ClockworkWaltz.mp3, https://storage.rootly.com/twilio/voicemail/ith_brahms-116-4.mp3, https://storage.rootly.com/twilio/voicemail/Mellotroniac_-_Flight_Of_Young_Hearts_Flute.mp3, https://storage.rootly.com/twilio/voicemail/BusyStrings.mp3, https://storage.rootly.com/twilio/voicemail/oldDog_-_endless_goodbye_%28instr.%29.mp3, https://storage.rootly.com/twilio/voicemail/MARKOVICHAMP-Borghestral.mp3, https://storage.rootly.com/twilio/voicemail/ith_chopin-15-2.mp3 The delay (seconds) after which the caller in redirected to voicemail
This prompts the caller to choose voicemail or connect live
This overrides the delay (seconds) in escalation levels
This overrides the delay (seconds) in escalation levels
This is used in escalation paths to determine who to page
The audio instructions callers will hear when they call this number, prompting them to select from available options to route their call
Paging targets that callers can select from when this live call router is configured as a phone tree.
Show child attributes
The ID of paging target
The type of the paging target
service, team, escalation_policy This is used in escalation paths to determine who to page
Was this page helpful?
curl --request POST \
--url https://api.rootly.com/v1/live_call_routers \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/vnd.api+json' \
--data '
{
"data": {
"type": "live_call_routers",
"attributes": {
"kind": "voicemail",
"name": "<string>",
"country_code": "AU",
"phone_type": "local",
"phone_number": "<string>",
"enabled": true,
"voicemail_greeting": "<string>",
"caller_greeting": "<string>",
"waiting_music_url": "https://storage.rootly.com/twilio/voicemail/ClockworkWaltz.mp3",
"sent_to_voicemail_delay": 123,
"should_redirect_to_voicemail_on_no_answer": true,
"escalation_level_delay_in_seconds": 123,
"should_auto_resolve_alert_on_call_end": true,
"alert_urgency_id": "<string>",
"calling_tree_prompt": "<string>",
"paging_targets": [
{
"id": "<string>",
"type": "service",
"alert_urgency_id": "<string>"
}
],
"escalation_policy_trigger_params": {
"id": "<string>",
"type": "service"
}
}
}
}
'{
"data": {
"id": "4b4ded7a-9079-47d4-8a78-85ad0c0dd98a",
"type": "live_call_routers",
"attributes": {
"kind": "voicemail",
"name": "live_call_router-prod",
"country_code": "US",
"phone_type": "toll_free",
"phone_number": "+14155552344",
"voicemail_greeting": "hello",
"slug": "live_call_router-prod",
"enabled": true,
"created_at": "2025-12-05T21:27:23.214-08:00",
"updated_at": "2025-12-05T21:27:23.240-08:00",
"calling_tree_prompt": "Press 1 for service, Press 2 for escalation policy",
"paging_targets": [
{
"id": "447b5884-cae6-443a-89e0-65a2787a251b",
"type": "service",
"alert_urgency_id": "b7454666-45ca-4dad-9b2f-9193cf6ae4a7"
},
{
"id": "a7366441-c4a6-42c6-bbc8-a0f5a62989d6",
"type": "escalation_policy",
"alert_urgency_id": "90a2f11d-9ff4-48bc-9226-f3caa6662916"
}
]
}
}
}