pass.window_closed

When this fires

A scheduled access window reached its end time. Everyone who held it has been removed from the plan's Telegram resources and their pass has ended — one purchase buys one window, so there is no next window to roll into.

This also fires for a window that never opened because the worker was unavailable for its entire span. Such a window is closed rather than opened late, so nobody is admitted to a window that has already finished.

Required ability

project-subscription-plan:view-any — token must carry this at mint time to subscribe an endpoint to this event.

Payload

{
  "id": "evt_01HX...",
  "type": "pass.window_closed",
  "created_at": "2026-09-21T03:00:02Z",
  "api_version": "2026-05-01",
  "project_id": "prj_01HX...",
  "data": {
    "plan_id": "pln_01HX...",
    "window_id": "psw_01HX...",
    "starts_at": "2026-09-20T13:00:00Z",
    "ends_at": "2026-09-21T03:00:00Z",
    "subscribers_affected": 47
  }
}

Field reference

Field	Type	Notes
`id`	string ULID	Unique event id, prefixed `evt_`. Use for idempotent processing.
`type`	string	Always `pass.window_closed` for this event.
`created_at`	ISO 8601 timestamp	Server-side emission time.
`api_version`	string	Webhook API contract version.
`project_id`	string ULID	Project this event belongs to.
`data.plan_id`	string ULID	The pass plan the window belongs to.
`data.window_id`	string ULID	The access window that closed.
`data.starts_at`	ISO 8601 timestamp	Window start, always UTC.
`data.ends_at`	ISO 8601 timestamp	Window end, always UTC.
`data.subscribers_affected`	integer	How many holders were removed and had their pass ended.

Caveats

Timestamps are UTC — convert to the plan's schedule timezone before showing them.
Each affected subscription also emits subscription.expired, and member.churned when it was the subscriber's last active subscription. De-duplicate if you consume several of these.
A cancelled window does not emit this event. Cancellation is a separate creator action that moves holders to another window or flags them for refund.

pass.window_opened — paired transition.
member.resource_removed — per-subscriber revocation.
Pass events overview — back to family overview.