{
"event": "plan_grant.updated",
"timestamp": "2026-06-23T14:30:00.000Z",
"organizationId": "8f14e45f-ceea-4e7a-9c3d-1c2b3a4d5e6f",
"mode": "live",
"apiVersion": "2026-07-31",
"data": {
"id": "pgr_1a2b3c4d",
"customerId": "user_123",
"subscriptionId": "sub_1a2b3c4d",
"basePlanId": "pln_starter",
"targetPlanId": "pln_pro",
"targetPlanReleaseId": "plr_1a2b3c4d",
"status": "active",
"duration": "until_date",
"durationCycles": null,
"startsAt": "2026-08-01T00:00:00.000Z",
"expiresAt": "2026-11-15T00:00:00.000Z",
"reason": "Extended evaluation",
"source": "dashboard",
"revokedAt": null,
"createdAt": "2026-08-01T00:00:00.000Z",
"updatedAt": "2026-08-15T12:00:00.000Z",
"events": [
{
"id": "gre_1a2b3c4d",
"type": "created",
"reason": "Two-month product evaluation",
"source": "api",
"previousExpiresAt": null,
"expiresAt": "2026-10-01T00:00:00.000Z",
"duration": "cycles",
"durationCycles": 2,
"requestedExpiresAt": null,
"createdAt": "2026-08-01T00:00:00.000Z"
},
{
"id": "gre_5e6f7g8h",
"type": "updated",
"reason": "Extended evaluation",
"source": "dashboard",
"previousExpiresAt": "2026-10-01T00:00:00.000Z",
"expiresAt": "2026-11-15T00:00:00.000Z",
"duration": "until_date",
"durationCycles": null,
"requestedExpiresAt": "2026-11-15T00:00:00.000Z",
"createdAt": "2026-08-15T12:00:00.000Z"
}
]
}
}Events
Plan grant updated
Fired after a plan grant duration or deadline is durably changed. The payload is the grant snapshot at that update.
{
"event": "plan_grant.updated",
"timestamp": "2026-06-23T14:30:00.000Z",
"organizationId": "8f14e45f-ceea-4e7a-9c3d-1c2b3a4d5e6f",
"mode": "live",
"apiVersion": "2026-07-31",
"data": {
"id": "pgr_1a2b3c4d",
"customerId": "user_123",
"subscriptionId": "sub_1a2b3c4d",
"basePlanId": "pln_starter",
"targetPlanId": "pln_pro",
"targetPlanReleaseId": "plr_1a2b3c4d",
"status": "active",
"duration": "until_date",
"durationCycles": null,
"startsAt": "2026-08-01T00:00:00.000Z",
"expiresAt": "2026-11-15T00:00:00.000Z",
"reason": "Extended evaluation",
"source": "dashboard",
"revokedAt": null,
"createdAt": "2026-08-01T00:00:00.000Z",
"updatedAt": "2026-08-15T12:00:00.000Z",
"events": [
{
"id": "gre_1a2b3c4d",
"type": "created",
"reason": "Two-month product evaluation",
"source": "api",
"previousExpiresAt": null,
"expiresAt": "2026-10-01T00:00:00.000Z",
"duration": "cycles",
"durationCycles": 2,
"requestedExpiresAt": null,
"createdAt": "2026-08-01T00:00:00.000Z"
},
{
"id": "gre_5e6f7g8h",
"type": "updated",
"reason": "Extended evaluation",
"source": "dashboard",
"previousExpiresAt": "2026-10-01T00:00:00.000Z",
"expiresAt": "2026-11-15T00:00:00.000Z",
"duration": "until_date",
"durationCycles": null,
"requestedExpiresAt": "2026-11-15T00:00:00.000Z",
"createdAt": "2026-08-15T12:00:00.000Z"
}
]
}
}Body
application/json
Response
200
Return any 2xx status code to acknowledge receipt of the event.
Was this page helpful?