Skip to content

Webhook Events

Complete list of events you can subscribe to.

License Events

license.created

Triggered when a new license is created.

json
{
  "event": "license.created",
  "timestamp": "2026-02-06T12:00:00.000Z",
  "data": {
    "id": "lic_xxx",
    "licenseKey": "MYPLUGIN-XXXX-XXXX-XXXX-XXXX",
    "productId": "prd_xxx",
    "customerEmail": "customer@example.com",
    "status": "active",
    "seats": 5,
    "expiresAt": "2027-02-06T12:00:00.000Z"
  }
}

license.activated

Triggered when a license is activated on a domain.

json
{
  "event": "license.activated",
  "timestamp": "2026-02-06T12:00:00.000Z",
  "data": {
    "licenseId": "lic_xxx",
    "licenseKey": "MYPLUGIN-XXXX-XXXX-XXXX-XXXX",
    "activationId": "act_xxx",
    "domain": "https://example.com",
    "productId": "prd_xxx"
  }
}

license.deactivated

Triggered when a license is deactivated from a domain.

json
{
  "event": "license.deactivated",
  "timestamp": "2026-02-06T12:00:00.000Z",
  "data": {
    "licenseId": "lic_xxx",
    "licenseKey": "MYPLUGIN-XXXX-XXXX-XXXX-XXXX",
    "activationId": "act_xxx",
    "domain": "https://example.com",
    "productId": "prd_xxx"
  }
}

license.expired

Triggered when a license reaches its expiration date.

json
{
  "event": "license.expired",
  "timestamp": "2026-02-06T12:00:00.000Z",
  "data": {
    "id": "lic_xxx",
    "licenseKey": "MYPLUGIN-XXXX-XXXX-XXXX-XXXX",
    "productId": "prd_xxx",
    "customerEmail": "customer@example.com",
    "expiredAt": "2026-02-06T00:00:00.000Z"
  }
}

license.revoked

Triggered when a license is manually revoked.

json
{
  "event": "license.revoked",
  "timestamp": "2026-02-06T12:00:00.000Z",
  "data": {
    "id": "lic_xxx",
    "licenseKey": "MYPLUGIN-XXXX-XXXX-XXXX-XXXX",
    "productId": "prd_xxx",
    "customerEmail": "customer@example.com"
  }
}

Customer Events

customer.created

Triggered when a new customer is created.

json
{
  "event": "customer.created",
  "timestamp": "2026-02-06T12:00:00.000Z",
  "data": {
    "id": "cus_xxx",
    "email": "customer@example.com",
    "name": "John Doe"
  }
}

customer.updated

Triggered when customer details are updated.

json
{
  "event": "customer.updated",
  "timestamp": "2026-02-06T12:00:00.000Z",
  "data": {
    "id": "cus_xxx",
    "email": "customer@example.com",
    "name": "John Doe",
    "changes": ["name", "email"]
  }
}

Payment Events

payment.completed

Triggered when a payment is successfully processed.

json
{
  "event": "payment.completed",
  "timestamp": "2026-02-06T12:00:00.000Z",
  "data": {
    "id": "pay_xxx",
    "amount": 4900,
    "currency": "usd",
    "customerId": "cus_xxx",
    "licenseId": "lic_xxx"
  }
}

payment.refunded

Triggered when a payment is refunded.

json
{
  "event": "payment.refunded",
  "timestamp": "2026-02-06T12:00:00.000Z",
  "data": {
    "id": "pay_xxx",
    "amount": 4900,
    "currency": "usd",
    "customerId": "cus_xxx"
  }
}

Subscription Events

subscription.created

Triggered when a new subscription starts.

json
{
  "event": "subscription.created",
  "timestamp": "2026-02-06T12:00:00.000Z",
  "data": {
    "id": "sub_xxx",
    "customerId": "cus_xxx",
    "planId": "pln_xxx",
    "status": "active",
    "currentPeriodEnd": "2027-02-06T12:00:00.000Z"
  }
}

subscription.cancelled

Triggered when a subscription is cancelled.

json
{
  "event": "subscription.cancelled",
  "timestamp": "2026-02-06T12:00:00.000Z",
  "data": {
    "id": "sub_xxx",
    "customerId": "cus_xxx",
    "cancelledAt": "2026-02-06T12:00:00.000Z",
    "endsAt": "2027-02-06T12:00:00.000Z"
  }
}

subscription.renewed

Triggered when a subscription renews.

json
{
  "event": "subscription.renewed",
  "timestamp": "2026-02-06T12:00:00.000Z",
  "data": {
    "id": "sub_xxx",
    "customerId": "cus_xxx",
    "currentPeriodEnd": "2028-02-06T12:00:00.000Z"
  }
}