Skip to main content
Phone numbers are how your agents connect to the phone network. You can buy numbers directly through Simple AI, or bring your own numbers via SIP integration.

​
Buying a Number

You can search for and purchase phone numbers from the Simple AI dashboard or through the API. When searching for numbers, you can filter by:
  • Country — the country the number is based in
  • Area code — a specific local area code
  • Capabilities — voice, SMS, or both
Once purchased, the number is immediately available for use.

​
Assigning an Agent

After buying a number, assign an agent to it to handle inbound calls. When someone calls that number, the assigned agent picks up and follows its configured prompt and flow. You can change the assigned agent at any time from the dashboard or via the Assign Agent API. A number can also be used for outbound calls without assigning an agent — just reference the number as the from_number when creating a call.

​
Inbound Calls

When an agent is assigned to a number:
  1. A call comes in to the number
  2. Simple AI routes it to the assigned agent
  3. The agent handles the conversation according to its configuration
  4. Optionally, a pre-call webhook runs before the agent picks up, allowing you to inject parameters
If no agent is assigned, inbound calls will not be answered.

​
Outbound Calls

Any number you own can be used as the caller ID for outbound calls. Pass it as the from_number when creating a call through the API or when setting up a campaign.

​
Releasing a Number

If you no longer need a number, you can release it. Released numbers are removed from your account and can no longer be used for inbound or outbound calls.

​
SIP Integration

If you already have phone numbers with your own carrier, you do not need to buy numbers through Simple AI. Instead, connect your existing numbers via SIP — see SIP Integration for details.

​
API Reference