Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Receive real-time event notifications for message delivery, SID status changes, and brand verification.
.jpg?fit=max&auto=format&n=IhWYk8R5R6sdJ_7C&q=85&s=7e3194d82fa9653ad2a2449b4f1a3073){kind=logo}
POST /v1/webhooks
webhooks:manage
{
"url": "https://yourapp.com/webhooks/senderz",
"events": ["message.delivered", "message.failed", "sid.status_changed"],
"secret": "whsec_your_signing_secret"
}
| Event | Trigger |
|---|---|
message.queued | Message accepted |
message.sent | Dispatched to carrier |
message.delivered | Carrier delivery confirmed |
message.undelivered | Carrier non-delivery confirmed |
message.failed | Rejected pre-dispatch |
| Event | Trigger |
|---|---|
sid.status_changed | Any SID status transition |
sid.registered | SID confirmed live on register |
sid.rejected | SID registration denied |
sid.expiring | SID approaching renewal deadline (30-day warning) |
| Event | Trigger |
|---|---|
brand.verified | Brand entity verified |
brand.rejected | Brand verification failed |
{
"id": "evt_x1y2z3",
"type": "message.delivered",
"created_at": "2026-07-17T14:30:03+10:00",
"data": {
"id": "msg_a1b2c3d4e5",
"status": "delivered",
"to": "+61400000000",
"sender_id": "TrackFast",
"reference": "shipment-SYD-90421",
"delivered_at": "2026-07-17T14:30:03+10:00",
"price": {
"amount": "0.055",
"currency": "AUD"
}
}
}
secret you provide at subscription time. The signature is sent in the X-Senderz-Signature header.
import hmac
import hashlib
def verify_webhook(payload_bytes, signature, secret):
expected = hmac.new(
secret.encode(),
payload_bytes,
hashlib.sha256
).hexdigest()
return hmac.compare_digest(expected, signature)
const crypto = require("crypto");
function verifyWebhook(payloadBuffer, signature, secret) {
const expected = crypto
.createHmac("sha256", secret)
.update(payloadBuffer)
.digest("hex");
return crypto.timingSafeEqual(
Buffer.from(expected),
Buffer.from(signature)
);
}
| Attempt | Delay |
|---|---|
| 1 | 30 seconds |
| 2 | 2 minutes |
| 3 | 15 minutes |
| 4 | 1 hour |
| 5 | 4 hours |
| 6 | 24 hours |
disabled and an email is sent to the organisation admin.