Skip to content

Get the signed Twilio inbound-Voice webhook URL for a verified BYO account

GET
/v1/telephony-accounts/{account_id}/inbound-voice-webhook
curl --request GET \
--url https://api.vocapable.com/v1/telephony-accounts/example/inbound-voice-webhook \
--header 'Authorization: Bearer <token>'

Return the account-level Voice URL a customer copies into Twilio’s number config.

The URL remains useless without Twilio’s account-specific request signature, and every accepted callback re-resolves its signed destination against an active carrier-owned voice number with a selected published agent. Managed or unverified accounts cannot publish an inbound route, so they never become a back door around the BYO verification boundary.

account_id
required
Account Id
string

Successful Response

Media typeapplication/json
InboundVoiceWebhookSummary

The exact signed Twilio Voice URL for one eligible BYO account.

It is publishable configuration, not a bearer capability: Twilio still signs every request with the account’s vaulted auth token, and the signed destination is then resolved against one active carrier-confirmed voice number with an explicit receiving agent. The route returns no useful response until all of those server-side checks pass.

object
url
required
Url
string
status_callback_url
Any of:
string
Examplegenerated
{
"url": "example",
"status_callback_url": "example"
}

Validation Error

Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
input
Input
ctx
Context
object
Examplegenerated
{
"detail": [
{
"loc": [
"example"
],
"msg": "example",
"type": "example",
"input": "example",
"ctx": {}
}
]
}