Webhooks

Receive real-time event notifications for sales, refunds, license changes, and new versions.

Coming Soon

Webhook support is currently in development. When released, webhooks will let you subscribe to platform events and receive HTTP POST notifications to your endpoint in real time — no polling required.

Planned Events

The following event types are planned for the initial webhook release:

Event	Description
`order.created`	A new purchase was completed
`order.refunded`	A purchase was refunded
`license.revoked`	A license key was revoked
`license.activated`	A server activated a license key
`version.published`	A new plugin version was published
`subscription.cancelled`	A subscription was cancelled
`subscription.expired`	A subscription lapsed after a failed payment

Planned Payload Format

All webhook payloads will follow a consistent envelope with an event field and a data object. Payloads will be signed with an HMAC-SHA256 signature sent in the X-PulsePlugin-Signature header.

json

{
  "id": "evt_01JXXX...",
  "event": "order.created",
  "created_at": "2026-05-03T14:22:10Z",
  "data": {
    "order_id": "...",
    "product_id": "...",
    "buyer_id": "...",
    "amount_cents": 999,
    "license_key": "PULSE-XXXX-XXXX-XXXX-XXXX"
  }
}

In the Meantime — Polling

While webhooks are not yet available, you can poll the GET /api/v1/products/:id/versions endpoint to detect new version publishes, or use the GET /api/v1/orders endpoint to track recent sales (within rate limits).