Skip to main content
POST
Import Twilio phone number

Authorizations

Authorization
string
header
required

Send your organization API key as Authorization: Bearer <key>.

Body

application/json

Credentials to register a number with the platform; store secrets securely on the client until sent.

phone_number
string
required

Number to import, typically E.164.

account_sid
string
required

Twilio Account SID (starts with AC).

auth_token
string
required

Twilio auth token for the account (used once at import).

label
string

Optional; defaults to a generic label when empty.

Response

Imported

A Twilio number linked to your organization for voice agents.

id
string<uuid>

App record id for this import.

phone_number
string

E.164 number.

phone_sid
string

Twilio IncomingPhoneNumber sid.

label
string

Friendly name in your project.

account_sid
string

Twilio account this number belongs to.

created_at
string

Created timestamp (string form).

updated_at
string

Last update timestamp (string form).