Phone API
API-first telephony service for AI agents. Provision phone numbers, place and receive calls with bidirectional audio streaming, receive and manage SMS/MMS text messages, retrieve transcripts, and subscribe to events via webhooks.
API base URL:
https://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}Texts
List texts
GETList SMS and MMS messages for a phone number
/api/v1/phone/numbers/{phone_number_id}/textsGet text
GETGet a single text message by ID
/api/v1/phone/numbers/{phone_number_id}/texts/{text_id}Update text
PATCHMark as read or delete a text message
/api/v1/phone/numbers/{phone_number_id}/texts/{text_id}Search texts
GETFull-text search across text messages
/api/v1/phone/numbers/{phone_number_id}/texts/searchList conversations
GETList conversation summaries with unread counts
/api/v1/phone/numbers/{phone_number_id}/texts/conversationsGet conversation
GETGet all messages with a specific remote number
/api/v1/phone/numbers/{phone_number_id}/texts/conversations/{remote_number}Update conversation
PATCHBulk-update read state for all messages in a conversation
/api/v1/phone/numbers/{phone_number_id}/texts/conversations/{remote_number}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.