Import a Twilio number

Import an existing phone number from your own Twilio account into your workspace.

POST /utils/import-twilio-number

Import a Twilio number

cURL

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>",
  "capabilities": [
    "voice",
    "sms"
  ]
}
'

200

{
  "phoneNumber": "<string>",
  "phoneNumberSid": "<string>",
  "message": "<string>"
}

Example Request

{
  "twilioNumber": "[phone]",
  "twilioAccountSid": "ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "twilioAccountAuthToken": "your-auth-token",
  "twilioCallerId": "PNxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "agentId": "your-agent-id",
  "capabilities": ["voice", "sms"]
}

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 — Convocore will configure the voice/SMS webhooks for you.

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

Minimum string length: 10

Pattern: ^\+

twilioAccountSid · string · required

twilioAccountAuthToken · string · required

twilioCallerId · string · required

workspaceId · string

agentId · string

capabilities · enum<string>[]

Available options: sms, voice

Response

200

application/json

Successful response

phoneNumber · string · required

phoneNumberSid · string · required

message · string · required