REST ClientPhone Numbers

set_cxml_webhook

View as MarkdownOpen in Claude

Route inbound calls on this phone number to a cXML (Twilio-compat / LAML) webhook. Despite the wire value laml_webhooks being plural, this creates a single cxml_webhook Fabric resource on the server.

This is a typed wrapper over update that sets call_handler to laml_webhooks and populates the URL fields for you.

For SWML webhooks, use set_swml_webhook instead.

Parameters

resource_id
strRequired

ID of the phone number to bind.

url
strRequired

Primary cXML webhook URL.

fallback_url
str | NoneDefaults to None

URL invoked when the primary URL fails.

status_callback_url
str | NoneDefaults to None

URL that receives call-status updates.

request_options
RequestOptions | NoneDefaults to None

Per-call timeout and retry overrides. See RequestOptions.

**extra
Any

Additional fields forwarded to update.

Returns

dict — The updated phone number resource.

Example

from signalwire.rest import RestClient
client = RestClient(
project="your-project-id",
token="your-api-token",
host="your-space.signalwire.com",
)
client.phone_numbers.set_cxml_webhook(
"phone-number-id",
"https://example.com/cxml",
fallback_url="https://example.com/cxml-fallback",
status_callback_url="https://example.com/status",
)