Skip to navigation
VoiceNumbers

Numbers

Numbers is how PolyAI connects your agent to the public phone network. Provision a number directly through PolyAI, bring your own Twilio number, or route through your existing contact-centre provider — every option terminates on the same agent runtime so the conversation logic is identical across channels. Manage everything in Voice > Numbers.

OptionBest forWhat you get
Buy a numberNo existing providerPurchase directly from PolyAI.
Twilio integrationExisting Twilio setupConnect your Twilio numbers. Voice, SMS, and Flex routing.
Outbound callingProactive outreachAgent-initiated calls through API or SIP.

You can also connect through other contact center platforms like Genesys, Five9, or NICE CXone with SIP. See Integrations for the full list.

Integration options

Buy a number

Purchase a number directly from PolyAI.

Twilio integration

Voice, SMS, and contact center routing with Twilio.

Outbound calling

Agent-initiated calls for reminders and follow-ups.

Twilio integration guides

Outbound calling

Agent-initiated calls for reminders, follow-ups, and notifications.

Automate with the Agents API

Telephony plumbing is scriptable too — helpful for bulk provisioning and for reshaping routing as part of a broader deployment.

Connectors bind phone numbers to voice infrastructure; phone numbers are E.164 strings routed through a connector. The Agents API has CRUD for both.

# Import a phone number onto an existing connector
curl -X POST https://api.us.poly.ai/v1/agents/AGENT_ID/telephony/phone-numbers/+442071234567 \
  -H "x-api-key: $POLYAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "connectorId": "conn_abc123" }'
# Reassign a number to a different connector
curl -X PATCH https://api.us.poly.ai/v1/agents/AGENT_ID/telephony/phone-numbers/+442071234567 \
  -H "x-api-key: $POLYAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "connectorId": "conn_new456" }'

See Connectors and Phone numbers for the full endpoint list.

Route management

Configure how calls are routed to your agent

Integrations

Connect to Genesys, Five9, NICE, and other platforms

SMS

Send text messages during voice conversations

Phone number endpoints

Import and reassign numbers via the Agents API.