Webhooks
Suppose a customer buys a license and your own order system needs to mark it as delivered. Add a webhook destination for your server and select license.created. When AuthlyX creates a license, it sends a signed request to that URL. Your server can record the event without polling AuthlyX every minute.
Add a destination
- Open Webhooks for the app and add a destination name, such as
Northstar Orders. - Enter an HTTPS URL on your server.
- Create and save a signing secret. Keep it on your server; AuthlyX does not need to show it again after setup.
- Choose only the events your server needs. For example, use
license.created,identity.pausedandplan.updatedif you synchronize license delivery and plan changes. - Send a test delivery. Check its status and response under Deliveries.
One app can have several destinations. For example, send license events to your order system and audit events to a separate monitoring service. Each destination has its own URL, secret and event list.
Verify before acting
Treat every webhook request as untrusted until its signature passes. Read the exact raw request body, then calculate HMAC-SHA256 using that destination’s secret over timestamp + "." + rawBody. Compare the result with the v1=... value in X-AuthlyX-Signature, and check that X-AuthlyX-Timestamp is recent. Verify the signature before parsing and using the event fields.
Save each event ID before processing it. AuthlyX retries temporary delivery failures, so the same event can arrive more than once. If your server already processed that event ID, return a 2xx response without repeating the action.
If your server is down
Return a non-2xx response when your server has not safely accepted the event. AuthlyX records the attempt and retries temporary failures. Use the Deliveries page to see status, response code and attempts, then retry where available.
Webhooks are useful for synchronizing your own services. They do not replace a live access check when a customer signs in. The SDK should still ask AuthlyX whether the license, user or device may access the app.

