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