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.
| Event | Fires when |
|---|---|
connector.installed | A connector was installed on a project: a pending installation, no credentials yet. |
connector.connected | The creator connected the installation with their credentials; it can act now. |
connector.status_changed | A probe or a verify moved the installation's state. |
connector.outage_opened | The platform refused the live installation outright; plans that unlock a place on it are off sale. |
connector.outage_closed | The outage ended: recovered, replaced or uninstalled, with how long it ran. |
connector.outage_compensated | The outage settled: how many members had its length banked on their purchase, and how many lost invites were re-sent. |
connector.doctor_completed | The connector doctor ran and found something different from last time. |
connector.settings_updated | A declared setting of the installation changed; which ones, never the values. |
connector.disconnected | The installation was disconnected: credentials wiped, row kept, members untouched. |
connector.uninstalled | The connector was uninstalled: grants revoked, resources detached, the row kept; with the counts. |
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.installed
A connector was installed on a project: a pending installation with no credentials yet.
connector.connected
The creator connected an installation with their credentials; the connector can act for the project now.
connector.disconnected
An installation was disconnected: the connector withdrew it, the credentials were wiped, the row stays.
connector.status_changed
A probe or a verify moved an installation's state: connected, degraded or revoked.
connector.settings_updated
A declared setting of an installation changed: which fields, never their values.
connector.uninstalled
A 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_completed
The connector doctor ran on an installation and found something different from the previous run.
connector.outage_opened
A platform refused a project's live installation (token revoked or regenerated, bot deleted) and the connector entered an outage.
connector.outage_closed
A connector outage ended: the installation answered again, another one took its place, or the creator uninstalled the connector.
connector.outage_compensated
A 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.
Compare with the current pages
How is this guide?