Webhook Events

Account events

  • account.connected: An account was connected for the first time, or a disconnected or needs-reauth account was reconnected (reason: reconnected); re-authorizing an account that is already connected emits nothing.
  • account.needs_reauth: An account's credentials stopped working and the account must be reconnected.
  • account.disconnected: An account was disconnected because the platform revoked access, the user disconnected it in the dashboard or deleted it through the API (reason: user_disconnected), or its profile was deleted (reason: profile_deleted).

Delivered as a POST to every active endpoint that subscribes to the event and whose profile access covers it. Delivery is at least once and events are not ordered, so deduplicate by id.

postWebhookaccountEvents

Payload

idstring required

Event id (evt_…). Stable across automatic retries and manual redeliveries; deduplicate on it.

type'account.connected' | 'account.needs_reauth' | 'account.disconnected' required
apiVersionstring required

Payload version.

createdAtstring date-time required

When the event was created.

Example payload

{
  "apiVersion": "2026-08-06"
}

Response

Acknowledges the delivery. Any other status, or no response within 10 seconds, schedules a retry.

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.