Create a new phone number
Create and configure a new phone number in the PIA Platform. This endpoint supports two phone number types:
- Import Phone Numbers (SIP) for custom SIP trunk integration
- PIA-managed phone numbers (provided by our platform)
The phone number will be validated and configured based on the provided settings. The created phone number can then be associated with AI agents to handle inbound and outbound calls.
Body
The phone number in E.164 format (e.g., +14155552671). Must include country code
Specifies this as a request to create an Import Phone Number (SIP provider) configuration
"sip"
A human-readable label for this phone number to help identify its purpose
The SIP URI where calls to this number should be terminated
Username for authenticating with the SIP trunk provider
Password for authenticating with the SIP trunk provider
ID of the AI agent that will handle incoming calls to this number
ID of the AI agent that will be used when making outbound calls from this number
The infrastructure region for SIP routing. 'global' for worldwide routing, 'bd' for Bangladesh-specific routing, 'bd_link3' for Bangladesh Link3 IPTSP routing
global
, bd
, bd_link3
The phone number in E.164 format (e.g., +14155552671). Must include country code
Specifies this as a request to create an Import Phone Number (SIP provider) configuration
"sip"
A human-readable label for this phone number to help identify its purpose
The SIP URI where calls to this number should be terminated
Username for authenticating with the SIP trunk provider
Password for authenticating with the SIP trunk provider
ID of the AI agent that will handle incoming calls to this number
ID of the AI agent that will be used when making outbound calls from this number
The infrastructure region for SIP routing. 'global' for worldwide routing, 'bd' for Bangladesh-specific routing, 'bd_link3' for Bangladesh Link3 IPTSP routing
global
, bd
, bd_link3
Specifies this as a request to create a Pia Platform managed phone number
"pia"
A human-readable label for this phone number to help identify its purpose
ID of the AI agent that will handle incoming calls to this number
ID of the AI agent that will be used when making outbound calls from this number
The phone number in E.164 format (e.g., +14155552671). Must include country code
The Twilio Account SID for authenticating with Twilio's API
The Twilio Auth Token for authenticating with Twilio's API
Specifies this as a request to create a direct Twilio integration phone number
"twilio"
ID of the AI agent that will handle incoming calls to this number
ID of the AI agent that will be used when making outbound calls from this number
Response
The phone number in E.164 format, including country code (e.g., +14155552671)
Unique identifier for this phone number record
Indicates this is an Import Phone Number (SIP provider)
"sip"
A human-readable label for this phone number
The SIP URI where calls are terminated
Username for SIP trunk authentication
Password for SIP trunk authentication
ID of the AI agent handling incoming calls
ID of the AI agent used for outbound calls
The infrastructure region for SIP routing: 'global' or 'bd' (Bangladesh)
global
, bd
, bd_link3
The phone number in E.164 format, including country code (e.g., +14155552671)
Unique identifier for this phone number record
Indicates this is an Import Phone Number (SIP provider)
"sip"
A human-readable label for this phone number
The SIP URI where calls are terminated
Username for SIP trunk authentication
Password for SIP trunk authentication
ID of the AI agent handling incoming calls
ID of the AI agent used for outbound calls
The infrastructure region for SIP routing: 'global' or 'bd' (Bangladesh)
global
, bd
, bd_link3
The phone number in E.164 format (e.g., +14155552671)
Unique identifier for this phone number record
Indicates this is a Pia Platform managed phone number
"pia"
A human-readable label for this phone number
ID of the AI agent handling incoming calls
ID of the AI agent used for outbound calls
The phone number in E.164 format, including country code (e.g., +14155552671)
Unique identifier for this phone number record
Indicates this is a direct Twilio integration phone number
"twilio"
A human-readable label for this phone number
The Twilio Account SID used for API authentication
The Twilio Auth Token used for API authentication
ID of the AI agent handling incoming calls
ID of the AI agent used for outbound calls