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 API key from the Inkbox console:
Get API keyAll API requests require authentication using a API key:
X-API-Key: YOUR_API_KEYPhone 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
Send text
POSTSend an outbound SMS from one of your phone numbers
/api/v1/phone/numbers/{phone_number_id}/textsList 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}/searchContact rules
Per-phone-number allow and block rules interpreted against the number's filter_mode (blacklist by default, whitelist on demand). See the Contact rules reference and the Filtering guide for semantics.
List contact rules
GETList allow/block rules for a phone number
/api/v1/phone/numbers/{phone_number_id}/contact-rulesCreate contact rule
POSTAdd an allow or block rule (E.164 exact match)
/api/v1/phone/numbers/{phone_number_id}/contact-rulesGet contact rule
GETFetch a single rule by ID
/api/v1/phone/numbers/{phone_number_id}/contact-rules/{rule_id}Update contact rule
PATCHChange action or status (admin-only)
/api/v1/phone/numbers/{phone_number_id}/contact-rules/{rule_id}Delete contact rule
DELETEDelete a rule (admin-only)
/api/v1/phone/numbers/{phone_number_id}/contact-rules/{rule_id}List org phone contact rules
GETOrg-wide aggregate list across every phone number (admin-only)
/api/v1/phone/contact-rulesWebhooks
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.