Skip to main content
POST
/
utils
/
import-twilio-number
Import a Twilio number
curl --request POST \
  --url https://eu-gcp-api.vg-stuff.com/v3/utils/import-twilio-number \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "twilioNumber": "<string>",
  "twilioAccountSid": "<string>",
  "twilioAccountAuthToken": "<string>",
  "twilioCallerId": "<string>",
  "workspaceId": "<string>",
  "agentId": "<string>"
}
'
{
  "phoneNumber": "<string>",
  "phoneNumberSid": "<string>",
  "message": "<string>"
}

​
Example Request

{
  "twilioNumber": "+14155551234",
  "twilioAccountSid": "ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "twilioAccountAuthToken": "your-auth-token",
  "twilioCallerId": "PNxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "agentId": "your-agent-id"
}
You need your Twilio Account SID, Auth Token, and the phone number’s SID from your Twilio Console.
Import numbers if you already have Twilio phone numbers you want to use with your AI agents.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
twilioNumber
string
required

The Twilio phone number to import (must start with +)

Minimum string length: 10
​
twilioAccountSid
string
required

Your Twilio Account SID

​
twilioAccountAuthToken
string
required

Your Twilio Auth Token

​
twilioCallerId
string
required

The Twilio Caller ID (phone number SID)

​
workspaceId
string

Optional workspace ID to associate the number with

​
agentId
string

Optional agent ID to assign the number to

Response

Successful response

​
phoneNumber
string
required

The imported phone number

​
phoneNumberSid
string
required

The Twilio SID for the phone number

​
message
string
required

Response message