plan.order_changed
The creator arranged the order plans appear in on the portal and in the bot, or reset it.
When this fires
A creator drags plans into a new order in the dashboard's Arrange Storefront Order dialog and saves, calls POST /api/v1/projects/{project}/plans/order, or runs the reorder_plans MCP tool. Resetting to the built-in order fires it too. The event carries the resulting order of every plan currently on sale, so a mirror of the storefront can re-sort itself without a second read.
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": "plan.order_changed",
"created_at": "2026-09-08T14:10:00Z",
"api_version": "2026-05-01",
"project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13",
"data": {
"project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13",
"plan_ids": [
"c4e82f16-93a7-4d5b-b81c-6e0f27a94d3b",
"b1a7c3d5-2e48-4f60-9a1b-7c5d3e820f94",
"a9d2e4f6-1b3c-4d5e-8f70-2c4e6a8b0d1f"
]
}
}Field reference
| Field | Type | Notes |
|---|---|---|
id | string ULID | Unique event id, prefixed evt_. Use for idempotent processing. |
type | string | Always plan.order_changed 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.project_id | string UUID | The same project, flat, for consumers that read data alone. |
data.plan_ids | array of UUIDs | Every active plan of the project in storefront order: pinned plans first, then the built-in order. |
The built-in order is passes first, then seasons, then subscriptions, each
group cheapest first. Plans created after an arrangement join the end in that
order until the creator arranges again, so plan_ids on this event may be
shorter than the plan list read a week later.
Related events
plan.created— a new plan joins the end of the storefront.plan.activated/plan.deactivated— a plan entering or leaving the storefront.- Plan events overview — back to family overview.
How is this guide?