v4

latestOpenAPI 3.1.1Apache 2.02026-07-31107278570.4 KB

Connected Account Status Updated

Triggered when a connected account's status changes between two states (for example PENDING_AUTH to ACTIVE, ACTIVE to EXPIRED, or any state to DISCONNECTED). Not triggered on account creation.

postWebhookconnected_account.status_updated

Payload

spec_versionstring required

The webhook specification version

idstring required

Unique identifier for the webhook event (must be prefixed with "evt_")

type'connected_account.status_updated' required

The event type

occurred_atstring date-time required

When the event occurred (ISO 8601 format)

environment_idstring required

The environment ID where the event occurred

object'ConnectedAccount' required

The type of object that triggered the webhook

Example payload

{
  "spec_version": "1",
  "id": "evt_101652975398683158",
  "type": "connected_account.status_updated",
  "occurred_at": "2025-12-02T06:31:34.895815554Z",
  "environment_id": "env_88640229614813449",
  "object": "ConnectedAccount",
  "data": {
    "id": "ca_133400349586228019",
    "identifier": "john@acmecorp.com",
    "connection_id": "conn_133400101014995480",
    "connection_name": "gmail",
    "provider": "GMAIL",
    "authorization_type": "OAUTH",
    "status": "EXPIRED",
    "old_status": "ACTIVE"
  }
}

Response

Webhook received successfully