Back to Help Center
For developers

Webhooks: reacting to license events

Subscribe to events like license.created and payout.settled to keep your systems in sync.

4 min read

Webhooks push events to your endpoint as they happen, so you never have to poll. Register a URL in the developer portal and select the events you care about.

Common events

  • license.created — a new license was issued.
  • license.renewed — an existing license was extended.
  • payout.settled — funds were released to a rights holder.
  • royalty.distributed — a royalty accrual was paid out.
{
  "type": "license.created",
  "data": {
    "id": "lic_456",
    "assetId": "asset_123",
    "anchor": "0xabc...def"
  }
}

Always verify the webhook signature before trusting a payload, and respond with a 2xx quickly — retry the work asynchronously if needed.

Was this article helpful?

Related articles