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.

When this fires

A creator uninstalls a connector from a project, from the Connectors tab, through DELETE /v1/projects/{project}/connectors/{key} or the uninstall_connector tool, after the impact preview. Uninstalling is distinct from disconnecting and never a deletion: every live grant on the connector's resources is revoked (member.resource_removed fires per grant), the resources are deactivated as detached with their external ids kept, the installation row stays with uninstalled_at, identities are never removed and no money moves by itself. The two opt-ins act on the plans left with nothing to grant: taking them off sale fires plan.deactivated per plan, cancelling their recurring subscriptions at period end fires subscription.cancelled per subscription.

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.uninstalled",
  "created_at": "2026-09-12T11:30:00Z",
  "api_version": "2026-05-01",
  "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13",
  "data": {
    "connector": "discord",
    "installation_id": "3b8f0c6e-2d41-4a97-9e5f-1c7d6b2a8e40",
    "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13",
    "grants_revoked": 41,
    "resources_detached": 2,
    "plans_unpublished": 1,
    "subscriptions_cancelled": 17
  }
}

Field reference

Field	Type	Notes
`id`	string ULID	Unique event id, prefixed `evt_`. Use for idempotent processing.
`type`	string	Always `connector.uninstalled` 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, kept with `uninstalled_at`.
`data.project_id`	string UUID	Mirrors top-level `project_id`.
`data.grants_revoked`	integer	Live grants revoked with reason `connector_uninstalled`; one `member.resource_removed` each.
`data.resources_detached`	integer	Resources deactivated and marked `detached`.
`data.plans_unpublished`	integer	Emptied plans taken off sale; `0` when the opt-in was off or nothing was emptied.
`data.subscriptions_cancelled`	integer	Recurring subscriptions cancelled at period end; `0` when the opt-in was off. One-time purchases are never counted.

Caveats

Members are told by email that their recurring subscription will not renew; nothing is taken from them before the end of the paid period.
Installing the connector again brings the same installation back as pending with its settings kept; the detached resources stay inactive until the creator relinks them.

connector.disconnected — the reversible act this is not.
connector.installed — the reinstall.
Connector events overview — back to family overview.