member.resource_added

When this fires

Subscriby asks the resource's connector to give a subscriber access to one of the resources their subscription grants — on Telegram, a join-request invite link named after them — and writes the grant to the access ledger. Each resource grant emits its own event. The event marks the grant, not the subscriber's arrival — they may not have opened the link yet; the ledger row named by grant_id moves from pending to granted when they do. A manual perk arrives here too, once the creator completes its task (creator_task.completed precedes it).

Required ability

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

Payload

{
  "id": "evt_01HX...",
  "type": "member.resource_added",
  "created_at": "2026-05-18T10:05:30Z",
  "api_version": "2026-05-01",
  "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13",
  "data": {
    "subscription_id": "5b7e2d40-1a86-4c39-97f2-e83d0b16c5a4",
    "subscriber_id": "2a91c4e7-6f38-4b52-8e0d-9c1a7b3f5d80",
    "resource_id": "b73c5f21-9d80-4a6e-8215-4f70ce13a9d6",
    "resource_kind": "telegram:channel",
    "connector": "telegram",
    "grant_id": "7d1c3e9a-2b64-4f0e-9a58-3c6b1d8e2f47",
    "mode": "bearer_link"
  }
}

Field reference

Field	Type	Notes
`id`	string ULID	Unique event id, prefixed `evt_`. Use for idempotent processing.
`type`	string	Always `member.resource_added` 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.subscription_id`	string UUID	Subscription that authorized the grant.
`data.subscriber_id`	string UUID	Subscriber's project-scoped user id.
`data.resource_id`	string UUID	Resource that was granted.
`data.resource_kind`	string	The resource's kind: `manual`, or `connector:kind` (`telegram:channel`).
`data.connector`	string, nullable	The connector that gave the access (`telegram` today); `null` for a manual perk the creator handed over.
`data.grant_id`	string UUID	The access ledger row; read it back with `GET /v1/subscriptions/{subscription}/grants`.
`data.mode`	enum: `bearer_link` \| `membership` \| `role` \| `creator_task`	How access was given: a personal invite link the member must use, a membership the connector added, a role, or a task for the creator.

Caveats

Ordering against the join event is not guaranteed: the dispatcher is queued before member.joined is emitted on the access-code path, and paid joins emit no member.* join event at all. Treat resource events as independent.
A manual perk emits this event only when its creator task is completed, never at purchase; until then the member's grant is pending and creator_task.opened is what fired.

member.resource_removed — paired transition.
member.joined, member.trial_joined — typical predecessors.
Member events overview — back to family overview.