Webhooks API

Webhooks let your server receive HTTP POST notifications when events happen in your Lizen account. See Webhooks concept for how delivery and signatures work.

Create a webhook

POST /v1/webhooks

Required permission: full_access or equivalent

{
  "url":    "https://your-server.com/webhooks/lizen",
  "events": ["key.created", "key.revoked", "activation.created"]
}

The secret for HMAC signature verification is returned only at creation.

List webhooks

GET /v1/webhooks

Secrets are never returned in list responses.

Get a webhook

GET /v1/webhooks/:id

Returns the webhook with the last 20 delivery attempts.

Update a webhook

PATCH /v1/webhooks/:id

Update url, events, or is_active.

Delete a webhook

DELETE /v1/webhooks/:id

Test a webhook

POST /v1/webhooks/:id/test

Sends a test key.created payload to the webhook URL. Logs the delivery attempt.

Event types

Event	When it fires
key.created	A new license key is generated
key.revoked	A license key is revoked
key.expired	A license key’s expiry date passes
key.extended	A license key’s expiry date is extended
activation.created	A new device activates a license
activation.deactivated	A device activation is removed
product.created	A new product is created
account.plan_changed	The account plan changes

Plan limits

Plan	Webhooks
Free	0
Hobby	3
Starter	10
Growth	Unlimited
Enterprise	Unlimited