Webhooks
Manage outbound webhook subscriptions for label.rendered events. The tenant is derived from your API key — never the path — so you can only ever touch your own subscriptions.
Endpoints#
| Method | Path | Purpose |
|---|---|---|
GET | /v1/webhooks | List your subscriptions. |
GET | /v1/webhooks/:id | Get one subscription. |
POST | /v1/webhooks/:id | Create or update a subscription. |
DELETE | /v1/webhooks/:id | Delete a subscription. |
GET | /v1/webhooks/:id/deliveries | Recent delivery attempts (newest first). |
Create / Update#
Only url is required. topics defaults to ["label.rendered"].
curl -X POST https://api.maddoxapi.dev/v1/webhooks/my-wms \
-H "Authorization: Bearer $MADDOX_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "url": "https://example.com/hooks/maddox" }'{
"status": "ok",
"scope": "tenant",
"id": "my-wms",
"version": 1,
"topics": ["label.rendered"],
"signing_secret": "whsec_…"
}Caution
signing_secret is returned once, on create. The url must be public HTTPS; loopback and metadata addresses are rejected.Related#
Webhooks (concept)
Delivery payload, retries, and HMAC verification.
Signed URLs
The signed link delivered in each event.