Webhooks
DevEntitle POSTs a signed JSON event to your URL the moment something happens, so your website or CRM can stay in sync without polling.
Add endpoints under Developers → Webhooks, or with POST /webhook-endpoints on the Management API. URLs must be HTTPS on a public address; private and internal addresses are refused.
Events
| Event | When | data |
|---|---|---|
license.created |
A licence was issued (panel, API, connected app or checkout) | license, plus change on updates (e.g. suspended, support_extended) |
license.updated |
Support extended, limit changed, suspended or reinstated, notes changed | license, plus change on updates (e.g. suspended, support_extended) |
license.revoked |
A licence was revoked or refunded | license, plus change on updates (e.g. suspended, support_extended) |
activation.created |
A product activated a licence on a new site or device | activation, license (id, key_hint) |
activation.removed |
A site or device was removed from a licence | activation, license (id, key_hint) |
release.published |
A release was published | release
|
order.paid |
A storefront order was paid (the licence is issued or renewed) | order |
order.refunded |
An order was refunded, in full or in part | order |
A paid storefront order sends order.paid and, for a new licence, license.created too. Subscribe to * to receive new event types automatically. Licence keys are never included in webhooks.
Payload and headers
POST /your/endpoint
Content-Type: application/json
DevEntitle-Event: license.created
DevEntitle-Delivery: 5f0d6b0e-… (the event id)
DevEntitle-Signature: t=1793390000,v1=6a1f…
{
"id": "5f0d6b0e-…",
"type": "license.created",
"created_at": "2026-11-01T09:30:00Z",
"vendor": {"id": 42, "slug": "acme-software"},
"data": {"license": {"id": 901, "key_hint": "K7Q2M", "status": "active", …}}
}
The objects in data have the same shape as in the Management API.
Check the signature
v1 is the hex HMAC-SHA256 of "<t>.<raw body>" with your endpoint's signing secret (whsec_…, under Signing secret on the endpoint). Reject the request if it doesn't match, or if t is more than 5 minutes old.
// PHP
$body = file_get_contents('php://input');
preg_match('/t=(\d+),v1=([0-9a-f]+)/', $_SERVER['HTTP_DEVENTITLE_SIGNATURE'] ?? '', $m);
$valid = $m
&& abs(time() - (int) $m[1]) < 300
&& hash_equals(hash_hmac('sha256', $m[1].'.'.$body, getenv('DEVENTITLE_WEBHOOK_SECRET')), $m[2]);
// Node.js (Express: use express.raw() for this route)
import { createHmac, timingSafeEqual } from 'node:crypto';
const [, t, v1] = req.get('DevEntitle-Signature').match(/t=(\d+),v1=([0-9a-f]+)/) ?? [];
const expected = createHmac('sha256', process.env.DEVENTITLE_WEBHOOK_SECRET).update(`${t}.${req.body}`).digest('hex');
const valid = v1 && Math.abs(Date.now() / 1000 - t) < 300 && timingSafeEqual(Buffer.from(v1), Buffer.from(expected));
Delivery and retries
- Answer with any 2xx within 10 seconds. Do slow work after answering.
- Anything else (or no answer) is retried after 1 min, 5 min, 30 min, 2 h, 6 h, 12 h, 24 h: 8 attempts in about two days. Then the delivery is marked failed.
- Redirects are not followed.
- Events can arrive more than once (retries, or a manual Redeliver). Use the event
idto ignore duplicates. - Order is not guaranteed. Use
created_at, or fetch the current state from the API. - Every delivery, its response and its error are listed on the endpoint's page for 90 days. Send test event sends a
ping.