Skip to main content
POST
Import number
Imports a Twilio number and assigns it to an agent. The API key must belong to the supplied user, and that user must have access to the agent. The agent must be on a paid plan and must not already have a business phone number. Only twilio is accepted as the source in this production version.
Treat the Twilio account SID and auth token as secrets. Do not place them in client-side code, screenshots, or logs.

Authorizations

X-Authorization
string
header
required

Body

application/json
uid
string
required

User ID

agentId
string
required

Agent ID (agent should not have a phone number assigned yet)

source
enum<string>
required

Phone number source (currently only supports 'twilio')

Available options:
twilio
twilioAccountSid
string
required

Twilio account SID

twilioAuthToken
string
required

Twilio auth token

phoneNumber
string
required

Phone number to import, includes country code. i.e +10123456789

Pattern: ^\+[1-9]\d{1,14}$
countryCode
string
required

Country code of the phone number, ISO 3166-1 alpha-2 format

Required string length: 2

Response

Successful response

message
string
required

Message indicating the result of the operation

Last modified on August 10, 2026