pass.window_scheduled

When this fires

A dated access window was created on a pass plan — either generated from the plan's recurrence, or placed by hand from Manage Access Windows.

This is the event that lets you mirror a schedule outward without polling for it. Every other pass.* event describes something happening to a window that already exists; this one is the window arriving.

Why this matters more once a series is involved

A Pass Series can be set to absorb new windows automatically as they are scheduled, and its holders are granted them at no charge. Without this event an integration has no way to learn a season grew except by re-reading the plan — the difference between a synced calendar and a stale one.

Required ability

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

Payload

{
  "id": "evt_01HX...",
  "type": "pass.window_scheduled",
  "created_at": "2026-09-01T09:14:22Z",
  "api_version": "2026-05-01",
  "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13",
  "data": {
    "plan_id": "c4e82f16-93a7-4d5b-b81c-6e0f27a94d3b",
    "window_id": "3d5a8c72-b016-4e94-8fa7-61c209d4e738",
    "starts_at": "2026-09-20T13:00:00+00:00",
    "ends_at": "2026-09-21T03:00:00+00:00",
    "timezone": "America/New_York",
    "source": "generated"
  }
}

Field reference

Field	Type	Notes
`id`	string ULID	Unique event id, prefixed `evt_`. Use for idempotent processing.
`type`	string	Always `pass.window_scheduled` for this event.
`created_at`	ISO 8601 timestamp	Server-side emission time.
`api_version`	string	Webhook API contract version.
`project_id`	string UUID	Project this event belongs to.
`data.plan_id`	string UUID	The pass plan the window belongs to.
`data.window_id`	string UUID	The window that was created. This is the id a Pass Series points at.
`data.starts_at`	ISO 8601 timestamp	Window start, always UTC.
`data.ends_at`	ISO 8601 timestamp	Window end, always UTC.
`data.timezone`	string, nullable	The IANA zone the schedule was authored in. Render `starts_at`/`ends_at` in this, not UTC. `null` when the plan has no timezone recorded — fall back to UTC.
`data.source`	string	`generated` (built from the plan's recurrence) or `manual` (placed by hand).

Caveats

Editing a schedule regenerates windows in bulk. Saving a pass plan rebuilds its unsold future windows, so a single edit can emit this many times in quick succession. Batch on your side rather than treating each as an isolated announcement.
Regeneration never touches a window somebody bought, a window a series points at, or one a creator pinned — so those are not deleted and re-created, and do not re-emit.
source: manual windows are never rebuilt by a schedule edit. They fire this once, when placed.
Timestamps are UTC. timezone is on the payload precisely so you do not have to look the plan up to render them correctly.

pass.window_opened — the same window reaching its start time.
pass.window_cancelled — a window being withdrawn.
pass_series.leg_added — a rule absorbing a newly-scheduled window into a live season.
Pass events overview — back to family overview.