creator_task.opened

A purchase entitles a subscriber to a manual perk, so the creator has something to do by hand.

When this fires

A subscription becomes active (or a pass window opens) on a plan that includes a manual resource — a perk no connector can give, which the creator hands over themselves. The access ledger records a creator_task grant in state pending and opens a task naming the member and the perk; this event carries that task. One event per manual resource the purchase entitles the member to. Nothing is sent to the member by a bot for a manual perk; the portal shows the perk as arranged by the organiser.

Required ability

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

Payload

{
  "id": "evt_01HX...",
  "type": "creator_task.opened",
  "created_at": "2026-09-12T10:05:30Z",
  "api_version": "2026-05-01",
  "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13",
  "data": {
    "task_id": "9e4b2c71-3d58-4a6f-b0e2-7c1d5f8a9b34",
    "grant_id": "7d1c3e9a-2b64-4f0e-9a58-3c6b1d8e2f47",
    "subscription_id": "5b7e2d40-1a86-4c39-97f2-e83d0b16c5a4",
    "subscriber_id": "2a91c4e7-6f38-4b52-8e0d-9c1a7b3f5d80",
    "resource_id": "b73c5f21-9d80-4a6e-8215-4f70ce13a9d6",
    "resource_kind": "manual",
    "instructions": "Give Ada Lovelace access to Welcome packet.",
    "due_at": null
  }
}

Field reference

Field	Type	Notes
`id`	string ULID	Unique event id, prefixed `evt_`. Use for idempotent processing.
`type`	string	Always `creator_task.opened` 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.task_id`	string UUID	The task; what `POST …/creator-tasks/{task}/complete` takes.
`data.grant_id`	string UUID	The access ledger row, in state `pending` with mode `creator_task`.
`data.subscription_id`	string UUID	Subscription that entitles the member.
`data.subscriber_id`	string UUID	Subscriber's project-scoped user id.
`data.resource_id`	string UUID	The manual resource.
`data.resource_kind`	string	Always `manual`: only a manual perk opens a creator task.
`data.instructions`	string	What the creator has to do, in the creator's locale: the member's name and the perk.
`data.due_at`	ISO 8601 timestamp \| null	When the perk is due; null for continuous access, the window's start for a dated pass.

Caveats

A task is opened once per purchase, resource and window; a retry of the granting job does not open a second one.
A purchase that ends before the task is done revokes the grant; the task then drops out of the open list without a creator_task.completed.

creator_task.completed — the task is done and the grant issued.
member.resource_added — raised for the same grant_id on completion.
Creator task events overview — back to family overview.