member.resource_removed

When this fires

A subscriber is evicted from a specific Telegram resource — after a subscription expires or is cancelled, after a ban, kick or removal, or when a pass window closes or is cancelled. Each resource revocation emits its own event. Nothing is emitted when another still-active subscription of theirs grants the same resource: the invite link is revoked but the member stays in.

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_removed",
  "created_at": "2026-06-18T10:06:00Z",
  "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_type": "channel"
  }
}

Field reference

Field	Type	Notes
`id`	string ULID	Unique event id, prefixed `evt_`. Use for idempotent processing.
`type`	string	Always `member.resource_removed` 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 whose grant was revoked.
`data.subscriber_id`	string UUID	Subscriber's project-scoped user id.
`data.resource_id`	string UUID	Resource the subscriber lost access to.
`data.resource_type`	enum: `channel` \| `group` \| `supergroup`	Resource flavour.

Caveats

Multiple revocations for the same subscriber typically arrive in close succession when a subscription expires; use SB-Event-Id for dedupe.
Manual (non-Telegram) resources never emit this event; the remover only walks resources with a linked Telegram chat, and emits only once it has issued the Telegram eviction call.

member.resource_added — paired transition.
subscription.expired, subscription.cancelled, member.kicked — typical triggers.
Member events overview — back to family overview.