Webhook

Connected Account Token Refresh Failed

​

Triggered when token refresh fails

Body·
application/json
  • environment_id
    Type: string
    min length:  
    1
    max length:  
    32     Pattern: ^env_
    required

    The environment ID where the event occurred

  • id
    Type: string
    min length:  
    1
    max length:  
    32     Pattern: ^evt_
    required

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

  • object
    Type: stringenum
    required

    The type of object that triggered the webhook

    values
    • Organization
    • Connection
    • Role
    • Directory
    • DirectoryUser
    • DirectoryGroup
    • Permission
    • OrgMembership
    • User
  • occurred_at
    Type: stringFormat: date-time
    required

    When the event occurred (ISO 8601 format)

  • spec_version
    Type: string Pattern: ^[0-9]+$
    required

    The webhook specification version

  • type
    Type: stringenum
    required

    The event type

    values
    • organization.created
    • organization.updated
    • organization.deleted
    • organization.sso_created
    • organization.sso_deleted
  • data
    Type: object

    The event payload (structure varies by event type)

  • display_name
    Type: string
    min length:  
    1
    max length:  
    200

    Human-readable display name for the event

  • organization_id
    Type: string
    min length:  
    1
    max length:  
    32     Pattern: ^org_

    The organization ID (if applicable)

Responses
  • 200

    Webhook received successfully

Request Example for postconnected_account.token_refresh_failed
{
  "spec_version": "1",
  "id": "evt_101649795042509316",
  "type": "connected_account.token_refresh_failed",
  "object": "ConnectedAccount",
  "occurred_at": "2025-12-02T05:59:59.250126407Z",
  "environment_id": "env_88640229614813445",
  "data": {
    "authorization_type": "OAUTH",
    "connection_id": "conn_101644109747323155",
    "id": "ca_101649788113519113",
    "identifier": "Clark",
    "provider": "GOOGLE_ADS",
    "status": "ACTIVE",
    "token_expires_at": "2025-12-02T06:59:57.237447778Z"
  }
}
No Body

Webhook received successfully