Skip to main content
Caller ID controls what phone number the recipient sees when you call them. You can have multiple numbers per workspace, set a primary default, and use local presence to auto-match area codes.

​
Selecting a caller ID

The Call from dropdown on the home screen and in the dialer sidebar shows all phone numbers provisioned in your workspace. Select the one you want to use for the current call or session. In the fullscreen workspace, the caller ID selector is available in the Settings tab.

​
Adding new numbers

Phone numbers are provisioned through Twilio via the Consuelo API:
1

Go to Settings

Navigate to Settings → Dialer → Phone Numbers
2

Search for available numbers

Enter an area code to search. The system calls GET /v1/phone-numbers/available?areaCode=X to find available Twilio numbers.
3

Provision a number

Select a number from the results and click Provision. This calls POST /v1/phone-numbers/provision with the area code and phone number.
4

Start using it

The number appears in your caller ID dropdown immediately.

​
Setting a primary number

Your primary number is the default caller ID used when no other selection is made:
  1. Go to Settings → Dialer → Phone Numbers
  2. Find the number you want as primary
  3. Click Set as Primary
This calls PUT /v1/phone-numbers/{sid}/primary on the backend.

​
Local presence toggle

When Prefer local presence calling is checked on the home screen, the system overrides your selected caller ID with the best area code match for the recipient. See Local Presence for details. The local presence toggle is also available in Settings → Dialer as a persistent preference.

​
Releasing numbers

To stop paying for a number you no longer need:
  1. Go to Settings → Dialer → Phone Numbers
  2. Find the number
  3. Click Release
This calls DELETE /v1/phone-numbers/{sid} on the backend.
Releasing a number is permanent. The number goes back to Twilio’s pool and may be assigned to someone else. You cannot get it back.

​
Caller ID lock

When you’re on a call, the system locks your caller ID for 5 minutes (CALLER_ID_LOCK_TTL = 5 min) to prevent another user in your workspace from using the same number simultaneously. The lock releases automatically when the call ends or the TTL expires.

​
Next steps