project.resource.linked

When this fires

A creator links a place from a connector: a Telegram channel, group or supergroup from the bot's picker, or any connector's own picker answering a link request. The connector's Core\Resources::create() writes the resource row and this event announces it. This creates the resource row; no project.resource.created precedes it.

Required ability

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

Payload

{
  "id": "evt_01HX...",
  "type": "project.resource.linked",
  "created_at": "2026-05-18T10:05:00Z",
  "api_version": "2026-05-01",
  "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13",
  "data": {
    "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13",
    "resource_id": "b73c5f21-9d80-4a6e-8215-4f70ce13a9d6",
    "connector": "telegram",
    "kind": "telegram:channel",
    "space_id": "3c1f7a58-2b6e-4d90-8f41-6a2e9c5d7b10",
    "title": "Research Premium Lounge"
  }
}

Field reference

Field	Type	Notes
`id`	string ULID	Unique event id, prefixed `evt_`. Use for idempotent processing.
`type`	string	Always `project.resource.linked` 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	Mirrors top-level `project_id`.
`data.resource_id`	string UUID	Resource identifier.
`data.connector`	string	The connector key the place is on (`telegram`, and each connector the marketplace lists as it launches).
`data.kind`	string	The resource's kind, `connector:kind` (`telegram:channel`, `telegram:group`, `telegram:supergroup`, a future connector's own kinds).
`data.space_id`	string UUID \| null	The space the resource gates, as `GET /v1/projects/{project}/resources/{resource}` returns it under `space.id`. Null only for a place whose installation the core has no row for yet.
`data.title`	string	The place's title at link time.

Caveats

Re-linking a place after an unlink creates a new resource row — the project.resource.linked you receive carries a different resource_id than the earlier project.resource.unlinked, and the unlinked row remains behind with space: null.
Linking the same place to the same project twice announces nothing the second time: the connector's write is idempotent and answers the existing resource.
A manual perk cannot be linked; it has no underlying place, so its kind is manual and it arrives through project.resource.created.

project.resource.unlinked — paired transition.
project.resource.created — the separate REST / MCP path for manual perks; not a predecessor of this event.
Project events overview — back to family overview.