Skip to main content
POST
/
v1
/
twilio
/
numbers
Import Twilio phone number
curl --request POST \
  --url https://api.vatel.ai/v1/twilio/numbers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "phone_number": "<string>",
  "account_sid": "<string>",
  "auth_token": "<string>",
  "label": "<string>"
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "phone_number": "<string>",
  "phone_sid": "<string>",
  "label": "<string>",
  "account_sid": "<string>",
  "created_at": "<string>",
  "updated_at": "<string>"
}

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).