v4

latestOpenAPI 3.1.1Apache 2.02026-07-31107278570.4 KB

Connected Account Updated

Triggered when a connected account is updated

postWebhookconnected_account.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.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

organization_idstring

The organization ID (if applicable)

object'ConnectedAccount' required

The type of object that triggered the webhook

display_namestring

Human-readable display name for the event

Example payload

{
  "spec_version": "1",
  "type": "connected_account.updated",
  "object": "ConnectedAccount",
  "data": {
    "id": "ca_101531404000559370",
    "identifier": "john@acmecorp.com",
    "connection_id": "conn_100668583155073286",
    "connection_name": "gmail",
    "provider": "GMAIL",
    "authorization_type": "OAUTH",
    "status": "ACTIVE",
    "token_expires_at": "2025-12-02T06:59:57.237447Z",
    "last_used_at": "2025-12-02T06:00:01.374253Z"
  }
}

Response

Webhook received successfully