Documentation

Numbers Shop

Every outbound and inbound call needs a phone number as the caller ID. This guide covers how to add a number to your workspace, assign it to an agent, and use it for single calls and bulk campaigns.

Ways to add a number

Buy a number

Provision a new number directly from the dashboard for the country you need.

Import from Twilio

Bring a number you already own by connecting your Twilio Account SID and Auth Token.

Connect a SIP trunk

Register a SIP trunk with your host, trunk name, and credentials.

Set up a number

1

Add the number

Go to Phone Numbers in the dashboard and buy a new number or import one from Twilio or SIP. Programmatically, use the Phone Number API.
2

Assign it to an agent

A number must have an agent assigned before it can place calls. Select the number and choose an agent, or call POST /api/phone-numbers/:id/assign with { "agent_id": "..." }.
3

Copy Phone Number ID for CRM / API

On the Phone Numbers page, each row shows Phone Number ID (e.g. 5707). Click Copy and paste it as from_number_id in dispatch APIs or CRM tools (e.g. Kreddy King → Automation → Outbound number). Never use the phone digits or Agent ID.
4

Use it in calls

Pass that ID as the caller ID when you dispatch a call or when you create a bulk campaign.

Good to know

  • A number can be attached to one agent at a time. Detach it to reassign.
  • Bulk campaigns require the selected number to have an agent assigned, or the campaign will be rejected.
  • Number availability and pricing depend on the country and your connected provider.
  • Phone Number ID (shown on the dashboard, also as externalId in the API) is what CRMs need for from_number_id — not the phone string and not the Agent ID.