Import Phone Number
Import a phone number from custom telephony & Bind agents
termination_uri, sip_trunk_auth_username, sip_trunk_auth_password, and transport as top-level properties — not nested inside a sip_outbound_trunk_config object.The response returns those same fields grouped under a sip_outbound_trunk_config object (see Get Phone Number), which is why the shapes look different between request and response.Authorizations
Body
SIP codec preferences for custom phone numbers only, used for inbound and outbound gateway calls. Retell-managed Twilio and Telnyx phone numbers do not support this setting. An empty list uses the gateway's default codecs. Codec names are extensible and are not limited to the examples.
1If set, Retell will send a webhook for inbound calls, where you can override the agent ID, set dynamic variables, reject the call, and configure other fields specific to that call. Includes call_inbound.call_id for deduplication across HTTP retries. Early setup failures may not create a call history record.
"https://example.com/inbound-webhook"
Response
Successfully imported a number.
If set, Retell will send a webhook for inbound calls, where you can override the agent ID, set dynamic variables, reject the call, and configure other fields specific to that call. Includes call_inbound.call_id for deduplication across HTTP retries. Early setup failures may not create a call history record.
"https://example.com/inbound-webhook"
If set, Retell will send a webhook for inbound SMS, where you can override the agent ID, set dynamic variables, reject the SMS, and configure other fields specific to that chat. Includes chat_inbound.chat_id for deduplication across HTTP retries. Early setup failures may not create a chat history record.
"https://example.com/inbound-sms-webhook"
When inbound call concurrency is reached and a slot does not free up after extended ringing, the call will fall back to this number. Can be either a Retell phone number or an external number. Cannot be the same as this phone number, and cannot be a number that already has its own fallback configured (prevents nested forwarding).
"+14155551234"

