Notification types
subscriptionUpdate
Fired when an existing billing subscription is updated, paused, resumed or deleted (Stripe webhook).
Delivered as the
notification socket event with type set to subscriptionUpdate.Fired when an existing billing subscription is updated, paused, resumed or deleted (Stripe webhook). Published on user/{ownerId} and {resourceType}/{resourceId}.
Payload for the subscriptionUpdate event.
Payload
| Property | Type | Required | Description |
|---|---|---|---|
type | string | yes | The specific type of notification event (matches the top-level key, e.g., 'workspaceCreate'). Every notification type is documented as its own event in this reference. |
initiatorId | string (uuid) | no | ID of the user or system that initiated the event. Null if initiatorType is 'system'. |
initiatorType | "user" | "system" | yes | Type of initiator (user or system). |
initiator | object | null | no | Populated initiator user object (if initiatorType is 'user'). |
resourceId | string (uuid) | yes | ID of the primary resource this notification pertains to. |
resourceType | string | yes | Type of the primary resource this notification pertains to. |
channels | string[] | no | The specific channels this notification was published on. Present on notification objects returned by the REST API only; the socket 'notification' payload omits it (and id). |
createdAt | string (date-time) | yes | Timestamp when the notification was created. |
tokens | object | no | Always an empty object for this event. |
changes | object | no |
changes
| Property | Type | Required | Description |
|---|---|---|---|
update | object[] | no |
update (items)
| Property | Type | Required | Description |
|---|---|---|---|
resourceId | string (uuid) | no | |
resourceType | "subscription" | no | |
resource | object | no | The updated subscription object. |