Jump to
Phone API
API-first telephony service for AI agents. Provision phone numbers, place and receive calls with bidirectional audio streaming, retrieve transcripts, and subscribe to events via webhooks.
API base URL:
https://api.inkbox.ai/api/v1/phoneQuick start
Create an account and get your service token from the Inkbox console:
Get service tokenAll API requests require authentication using a service token:
X-Service-Token: YOUR_SERVICE_TOKENPhone Numbers
Provision phone number
POSTProvision a new toll-free or local phone number via Telnyx
/api/v1/phone/numbersRelease phone number
DELETERelease a phone number from your organization
/api/v1/phone/numbers/{phone_number_id}List phone numbers
GETList all phone numbers for your organization
/api/v1/phone/numbersGet phone number
GETGet a single phone number by ID
/api/v1/phone/numbers/{phone_number_id}Update phone number
PATCHUpdate incoming call action, WebSocket URL, or webhook URL
/api/v1/phone/numbers/{phone_number_id}Calls
Place call
POSTInitiate an outbound call with bidirectional audio streaming
/api/v1/phone/place-callList calls
GETList calls for a phone number, newest first
/api/v1/phone/numbers/{phone_number_id}/callsGet call
GETGet a single call by ID
/api/v1/phone/numbers/{phone_number_id}/calls/{call_id}Transcripts
List transcripts
GETList transcript segments for a call, ordered by sequence
/api/v1/phone/numbers/{phone_number_id}/calls/{call_id}/transcriptsSearch transcripts
GETFull-text search across transcripts for a phone number
/api/v1/phone/numbers/{phone_number_id}/searchWebhooks
Webhooks are configured as a field on the phone number — set incoming_call_webhook_url via PATCH /numbers/{phone_number_id}. See the Webhooks guide for event types, payload format, and signature verification.