connector.connected

The creator connected an installation with their credentials; the connector can act for the project now.

When this fires

A creator completes a connector's connect flow on the dashboard: the connector checks the credentials, registers with its platform and the installation turns connected. For the first connector this is the Connect Bot modal, the platform bot's connectivity conversation and a Disaster Recovery bot replacement.

Required ability

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

Payload

{
  "id": "evt_01HX...",
  "type": "connector.connected",
  "created_at": "2026-09-12T10:06:00Z",
  "api_version": "2026-05-01",
  "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13",
  "data": {
    "connector": "telegram",
    "installation_id": "3b8f0c6e-2d41-4a97-9e5f-1c7d6b2a8e40",
    "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13",
    "display_name": "Research Bot",
    "handle": "research_bot"
  }
}

Field reference

Field	Type	Notes
`id`	string ULID	Unique event id, prefixed `evt_`. Use for idempotent processing.
`type`	string	Always `connector.connected` 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.connector`	string	The connector key.
`data.installation_id`	string UUID	The installation row.
`data.project_id`	string UUID	Mirrors top-level `project_id`.
`data.display_name`	string \| null	The platform's display name for the installation (the bot's name).
`data.handle`	string \| null	The platform's handle for the installation (the bot's username), without a leading `@`.

Caveats

Credentials are never in the payload. Read the installation back with GET /v1/projects/{project}/connectors/{key}/installation.
Reconnecting with new credentials fires this again for the same installation_id.

connector.installed — the pending row that preceded it, when the connector installs in two steps.
connector.status_changed — the installation's health afterwards.
Connector events overview — back to family overview.