Skip to main content
POST
Import a Twilio number

Example Request

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.

Dashboard workflow

You can also import from the UI without calling this endpoint directly:
  1. Open Agents → your agent → VoicePhone Numbers
  2. Click Import Twilio Number
  3. Enter credentials and capabilities — the number is assigned to that agent automatically
The agentId in the request body must match the agent you want to handle calls for that number.

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

Successful response

phoneNumber
string
required
phoneNumberSid
string
required
message
string
required