Skip to main content
POST
Import a Twilio number as a warm-transfer bridge number

Authorizations

x-api-key
string
header
required

Body

application/json

Request body for importing a Twilio number as a bridge number.

Accepts either the Twilio Phone Number SID (PN…) or the E.164 phone number (+1…) — we resolve the canonical SID from Twilio either way. We resolve the Twilio account credentials from the org's Nango-connected Twilio integration (the same credentials SMS/voice already use). Bridge numbers are BYO-only: the org must have a connected Twilio integration or the import is rejected.

twilio_number_sid
string
required
Required string length: 1 - 64
integration_connection_id
string<uuid> | null

BYOT only. Pin the import to a specific connected Twilio integration. Required when the org has more than one connected Twilio integration; when omitted, the service auto-discovers the org's single connected integration and 422s on ambiguity.

Response

Successful Response

Public view of a bridge number — never exposes credentials.

id
string<uuid>
required
phone_e164
string
required
twilio_sid
string
required
status
string
required
created_at
string<date-time>
required
integration_connection_id
string<uuid> | null