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

The subscription ID.

featureCodestring

The seats feature code.

currentSeatsnumber

The seat count after the change.

includedSeatsnumber

The included seat limit of the plan.

{
  "event": "seats.limit_reached",
  "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",
    "currentSeats": 5,
    "includedSeats": 5
  }
}

Cuándo se dispara

Cuando un cambio de asientos lleva el conteo desde por debajo del límite de asientos incluidos del plan hasta igualarlo o superarlo. Se dispara una vez por cada cruce: quitar asientos y volver a agregarlos por encima del límite lo dispara de nuevo. Los planes con asientos ilimitados nunca lo disparan.

Los asientos no se bloquean en el límite: se permiten conteos por encima de la cantidad incluida y se cobran como excedente cuando el plan lo habilita.

Úsalo para sugerir una mejora a un nivel superior antes de que comience el excedente.