Payload

All webhook payloads follow a consistent top-level structure with event-specific data nested within the data object.

subscriptionIdstring

The subscription ID.

customerIdstring

The customer ID. Returns your externalId if you provided one when creating the customer, otherwise returns the Commet publicId.

addonWebhookAddonRef

The add-on: id and name.

featureCodestring

The feature the add-on unlocked or extended.

{
  "event": "addon.deactivated",
  "timestamp": "2026-06-23T14:30:00.000Z",
  "organizationId": "8f14e45f-ceea-4e7a-9c3d-1c2b3a4d5e6f",
  "mode": "live",
  "apiVersion": "2026-07-31",
  "data": {
    "subscriptionId": "sub_1a2b3c4d",
    "customerId": "user_123",
    "addon": {
      "id": "adn_5e6f7g8h",
      "name": "Extra Storage"
    },
    "featureCode": "storage"
  }
}

Cuándo se dispara

Cuando un complemento activo se desactiva, ya sea mediante DELETE /subscriptions/{id}/addons/{addonId} o el portal del cliente. El complemento deja de facturarse en la próxima renovación.

customer.state_changed se dispara junto con él con el trigger addon_deactivated.

Úsalo para revocar la feature del complemento en tu aplicación.