Payload

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

customerIdstring

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

subscriptionIdstring | null

The live subscription ID, or null when the customer has no live subscription.

featureCodestring

The seats feature code.

previousSeatsnumber

The seat count before the change.

currentSeatsnumber

The seat count after the change.

{
  "event": "seats.updated",
  "timestamp": "2026-06-18T09:12:00.000Z",
  "organizationId": "org_abc123",
  "mode": "live",
  "apiVersion": "2026-06-10",
  "data": {
    "customerId": "user_123",
    "subscriptionId": "sub_1a2b3c4d",
    "featureCode": "editors",
    "previousSeats": 3,
    "currentSeats": 5
  }
}

Cuándo se dispara

Toda mutación de asientos lo dispara: los endpoints de asientos del SDK (add, set, remove, bulk) y los eventos de asientos manuales creados desde el dashboard. El payload incluye el conteo absoluto anterior y el nuevo para la feature.

customer.state_changed se dispara junto con él con el trigger seats_updated, llevando el estado completo de entitlement, incluido el resumen de asientos.

Úsalo para mantener tu propia UI de gestión de miembros sincronizada con los asientos facturados.