Skip to main content
Every outbound call needs a caller ID. You manage your phone numbers from the Numbers page.

​
My numbers

The My Numbers tab shows all the numbers on your org. Each one is in E.164 format and can be used as the from_number field in API requests.

​
Getting new numbers

Switch to Acquire Numbers to pick up a new one:
1

Search by area code

Type in a US area code to see what’s available.
2

Pick a number

Choose one from the list.
3

Confirm

It’s provisioned instantly. You can use it in calls right away.

​
Using a specific number

API calls can use any active number owned by your org. If you omit from_number, CallingBox uses your org’s oldest active purchased number. To use a different one, pass from_number: 
{
  "to": "+15551234567",
  "from_number": "+15559876543",
  "prompt": "Confirm appointment tomorrow at 2pm"
}
If you’re using the Python SDK, the argument is from_ instead of from_number: 
import callingbox

call = callingbox.calls.create(
    to="+15551234567",
    prompt="Confirm appointment tomorrow at 2pm",
    from_="+15559876543",
)
For the full programmatic flow, including searching and purchasing numbers through the public API, see the Python SDK guide.

​
Releasing numbers

You can release a number from the My Numbers tab. Once released, it goes back to the pool and you can’t use it anymore.
Only US numbers are available right now. International numbers are on the roadmap.