List webhooks
Returns all of your webhook subscriptions, newest first, as a bare JSON array. The body is null rather than [] when you have none, so treat null as an empty list.
curl --request GET \
--url https://api.vobiz.ai/api/v1/sms/webhooks \
--header 'X-Auth-ID: <api-key>' \
--header 'X-Auth-Token: <api-key>'from vobiz import Vobiz
client = Vobiz(api_key="MA_XXXXXXXX", auth_token="YOUR_AUTH_TOKEN")
client.sms.webhooks.list_webhooks()
const options = {
method: 'GET',
headers: {'X-Auth-ID': '<api-key>', 'X-Auth-Token': '<api-key>'}
};
fetch('https://api.vobiz.ai/api/v1/sms/webhooks', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));[
{
"id": "8d4f2a6b-3e1c-4b9a-a7d2-5c8e1f0b6a93",
"accountId": "MA_XXXXXXXX",
"url": "https://example.com/vobiz/webhooks",
"secret": "YOUR_WEBHOOK_SECRET",
"events": [
"message.received",
"message.delivered",
"message.failed"
],
"active": true,
"createdAt": "2026-10-18T07:22:11Z"
}
]{
"error": "missing or invalid credentials"
}{
"error": "internal error"
}Authorizations
Your Vobiz account Auth ID (MA_XXXXXXXX).
Your Vobiz account Auth Token.
Response
Your subscriptions, or null when there are none.
Unique identifier of the subscription (UUID). Use it with GET, PUT and DELETE /webhooks/{id}.
"8d4f2a6b-3e1c-4b9a-a7d2-5c8e1f0b6a93"
Auth ID of the account that owns the subscription, for example MA_XXXXXXXX.
"MA_XXXXXXXX"
The URL that receives POST deliveries.
"https://example.com/vobiz/webhooks"
The signing secret for X-Webhook-Signature, returned in clear. Keep it out of logs and client-side code.
"YOUR_WEBHOOK_SECRET"
Event names delivered to this URL. An event is delivered only when its name appears here exactly.
A messaging event name you can subscribe to: message.status (delivery state changed), message.delivered (reached the handset), message.failed (could not be delivered), message.received (inbound message) or broadcast.updated (broadcast status or counters changed).
message.status, message.delivered, message.failed, message.received, broadcast.updated [
"message.received",
"message.delivered",
"message.failed"
]
true when deliveries are on. New subscriptions start true; set it with PUT /webhooks/{id}.
true
When the subscription was created (ISO 8601). Read it from GET /webhooks/{id} or GET /webhooks.
"2026-10-18T07:22:11Z"
Was this page helpful?
curl --request GET \
--url https://api.vobiz.ai/api/v1/sms/webhooks \
--header 'X-Auth-ID: <api-key>' \
--header 'X-Auth-Token: <api-key>'from vobiz import Vobiz
client = Vobiz(api_key="MA_XXXXXXXX", auth_token="YOUR_AUTH_TOKEN")
client.sms.webhooks.list_webhooks()
const options = {
method: 'GET',
headers: {'X-Auth-ID': '<api-key>', 'X-Auth-Token': '<api-key>'}
};
fetch('https://api.vobiz.ai/api/v1/sms/webhooks', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));[
{
"id": "8d4f2a6b-3e1c-4b9a-a7d2-5c8e1f0b6a93",
"accountId": "MA_XXXXXXXX",
"url": "https://example.com/vobiz/webhooks",
"secret": "YOUR_WEBHOOK_SECRET",
"events": [
"message.received",
"message.delivered",
"message.failed"
],
"active": true,
"createdAt": "2026-10-18T07:22:11Z"
}
]{
"error": "missing or invalid credentials"
}{
"error": "internal error"
}