DevEntitle

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

EventWhendata
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 id to 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.