Skip to main content
POST
/
v1
/
identity
/
org
/
bridge-numbers
Import a Twilio number as a warm-transfer bridge number
curl --request POST \
  --url https://api-sandbox.featherhq.com/v1/identity/org/bridge-numbers \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "twilio_number_sid": "<string>"
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "phone_e164": "<string>",
  "twilio_sid": "<string>",
  "status": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "integration_connection_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

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

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