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
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
Specifies this as a request to create an Import Phone Number (SIP provider) configuration
sip The infrastructure region for SIP routing. 'global' for worldwide routing, 'bd' for Bangladesh-specific routing
global, bd The SIP URI where calls to this number should be terminated
Password for authenticating with the SIP trunk provider
Username for authenticating with the SIP trunk provider
Response
The phone number in E.164 format (e.g., +14155552671)
Unique identifier for this phone number record
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
Indicates this is an Import Phone Number (SIP provider)
sip The infrastructure region for SIP routing: 'global' or 'bd' (Bangladesh)
global, bd The SIP URI where calls are terminated
Password for SIP trunk authentication
Username for SIP trunk authentication