connector.* events
A project's connectors as they are installed, connected, verified, configured and disconnected: the family every connector answers to.
A project's connectors as they are installed, connected, verified, configured and disconnected: the family every connector answers to.
A project runs on connectors: the platforms it gates access on, sends messages through and takes payments from. Each one the project runs is an installation, and every move in an installation's life is announced here: it is installed (a pending row, no credentials yet), connected (the creator handed the connector its credentials), verified or probed (its state moved), configured (a declared setting changed), disconnected (the credentials wiped, the row kept) and uninstalled (its grants revoked and resources detached, the row still kept). The events name Subscriby ids and the connector key only; a platform's own identifiers, tokens and settings values never travel in a webhook.
Background
Read them together with the API
The installation_id in every payload is the id of the rows the project's installations endpoint lists, and connector is the key of a card in the connector directory. A consumer that keeps a mirror of a project's connectors applies these events to those rows.
Example envelope
{
"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"
}
}Required ability
Every connector.* event requires project-connector:view on the subscribing token and carries the project's project_id.
Events
connector.installedA connector was installed on a project: a pending installation with no credentials yet.connector.connectedThe creator connected an installation with their credentials; the connector can act for the project now.connector.disconnectedAn installation was disconnected: the connector withdrew it, the credentials were wiped, the row stays.connector.status_changedA probe or a verify moved an installation's state: connected, degraded or revoked.connector.settings_updatedA declared setting of an installation changed: which fields, never their values.connector.uninstalledA connector was uninstalled from a project: its grants revoked, its resources detached, the installation row kept, with the counts of what that touched.connector.doctor_completedThe connector doctor ran on an installation and found something different from the previous run.connector.outage_openedA platform refused a project's live installation (token revoked or regenerated, bot deleted) and the connector entered an outage.connector.outage_closedA connector outage ended: the installation answered again, another one took its place, or the creator uninstalled the connector.connector.outage_compensatedA closed connector outage settled: how many members had time banked, how much each received, and how many invites lost during the outage were re-sent.How is this guide?
Last updated on