plan.deleted

This is the final event you will receive for the given plan_id.

When this fires

The plan is hard-deleted from the project. Active subscriptions on the plan continue to honor their existing term.

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": "plan.deleted",
  "created_at": "2026-05-18T10:05:00Z",
  "api_version": "2026-05-01",
  "project_id": "prj_01HX...",
  "data": {
    "plan": {
      "id": "pln_01HX..."
    }
  }
}

Field reference

Field	Type	Notes
`id`	string ULID	Unique event id, prefixed `evt_`. Use for idempotent processing.
`type`	string	Always `plan.deleted` 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	Plan that was deleted.

Caveats

Reads of the plan after this event return 404. Existing subscriptions continue to reference the plan id internally.
PSP catalog rows are tombstoned but not necessarily deleted at the provider — use the dashboard for a manual cleanup if required.

plan.deactivated — typical predecessor.
plan.created — first event in the lifecycle.
Plan events overview — back to family overview.