seats.updated

{ "event": "seats.updated", "timestamp": "2026-06-23T14:30:00.000Z", "organizationId": "8f14e45f-ceea-4e7a-9c3d-1c2b3a4d5e6f", "mode": "live", "apiVersion": "2026-08-27", "data": { "customerId": "user_123", "subscriptionId": "sub_1a2b3c4d", "featureCode": "editors", "previousSeats": 3, "currentSeats": 5 } }

When this fires

Every seat mutation fires it: the SDK seat endpoints (add, set, remove, bulk) and manual seat events created from the dashboard. The payload carries the previous and the new absolute count for the feature.

customer.state_changed fires alongside it with trigger seats_updated, carrying the full entitlement state including the seats summary.

Use it to keep your own member-management UI in sync with billed seats.

Body

application/json

string

required

event

string

required

Allowed value: "seats.updated"

timestamp

string

required

organizationId

string

required

mode

enum<string>

required

Available options:

live,

sandbox

apiVersion

string

required

data

object

required

Show child attributes

Response

200

Return any 2xx status code to acknowledge receipt of the event.

Overview

Events

When this fires

Body

Response

​When this fires

Body

Response

When this fires