Connected Account Events

`connected_account.connected`

A connected account was connected for the first time or was reconnected after being disconnected.

{
  "connect_webview_id": "00000000-0000-0000-0000-000000000000",
  "connected_account_custom_metadata": {},
  "connected_account_id": "00000000-0000-0000-0000-000000000000",
  "created_at": "2025-01-01T00:00:00.000Z",
  "customer_key": "",
  "event_description": "A connected account was connected for the first time or was reconnected after being disconnected.",
  "event_id": "00000000-0000-0000-0000-000000000000",
  "event_type": "connected_account.connected",
  "occurred_at": "2025-01-01T00:00:00.000Z",
  "workspace_id": "00000000-0000-0000-0000-000000000000"
}

Properties

connect_webview_id

String (UUID)

ID of the Connect Webview associated with the event.

connected_account_custom_metadata

Object

Custom metadata of the connected account, present when connected_account_id is provided.

connected_account_id

String (UUID)

ID of the affected connected account.

created_at

String (ISO 8601)

Date and time at which the event was created.

customer_key

String

The customer key associated with this connected account, if any.

event_description

String

Human-readable description of the event. Persisted when the event is created (so the creating code, including a provider, can supply a tailored description) and otherwise derived from the event.

event_id

String (UUID)

ID of the event.

event_type

Enum (String)

Value: connected_account.connected

occurred_at

String (ISO 8601)

Date and time at which the event occurred.

workspace_id

String (UUID)

ID of the workspace associated with the event.

`connected_account.created`

A connected account was created.

{
  "connect_webview_id": "00000000-0000-0000-0000-000000000000",
  "connected_account_custom_metadata": {},
  "connected_account_id": "00000000-0000-0000-0000-000000000000",
  "created_at": "2025-01-01T00:00:00.000Z",
  "event_description": "A connected account was created.",
  "event_id": "00000000-0000-0000-0000-000000000000",
  "event_type": "connected_account.created",
  "occurred_at": "2025-01-01T00:00:00.000Z",
  "workspace_id": "00000000-0000-0000-0000-000000000000"
}

Properties

connect_webview_id

String (UUID)

ID of the Connect Webview associated with the event.

connected_account_custom_metadata

Object

Custom metadata of the connected account, present when connected_account_id is provided.

connected_account_id

String (UUID)

ID of the affected connected account.

created_at

String (ISO 8601)

Date and time at which the event was created.

event_description

String

Human-readable description of the event. Persisted when the event is created (so the creating code, including a provider, can supply a tailored description) and otherwise derived from the event.

event_id

String (UUID)

ID of the event.

event_type

Enum (String)

Value: connected_account.created

occurred_at

String (ISO 8601)

Date and time at which the event occurred.

workspace_id

String (UUID)

ID of the workspace associated with the event.

`connected_account.successful_login`

A connected account had a successful login using a Connect Webview.

{
  "connect_webview_id": "00000000-0000-0000-0000-000000000000",
  "connected_account_custom_metadata": {},
  "connected_account_id": "00000000-0000-0000-0000-000000000000",
  "created_at": "2025-01-01T00:00:00.000Z",
  "event_description": "A connected account had a successful login using a Connect Webview.",
  "event_id": "00000000-0000-0000-0000-000000000000",
  "event_type": "connected_account.successful_login",
  "occurred_at": "2025-01-01T00:00:00.000Z",
  "workspace_id": "00000000-0000-0000-0000-000000000000"
}

Properties

connect_webview_id

String (UUID)

ID of the Connect Webview associated with the event.

connected_account_custom_metadata

Object

Custom metadata of the connected account, present when connected_account_id is provided.

connected_account_id

String (UUID)

ID of the affected connected account.

created_at

String (ISO 8601)

Date and time at which the event was created.

event_description

String

Human-readable description of the event. Persisted when the event is created (so the creating code, including a provider, can supply a tailored description) and otherwise derived from the event.

event_id

String (UUID)

ID of the event.

event_type

Enum (String)

Value: connected_account.successful_login

occurred_at

String (ISO 8601)

Date and time at which the event occurred.

workspace_id

String (UUID)

ID of the workspace associated with the event.

`connected_account.disconnected`

A connected account was disconnected.

{
  "connected_account_custom_metadata": {},
  "connected_account_errors": [],
  "connected_account_id": "00000000-0000-0000-0000-000000000000",
  "connected_account_warnings": [],
  "created_at": "2025-01-01T00:00:00.000Z",
  "event_description": "A connected account was disconnected.",
  "event_id": "00000000-0000-0000-0000-000000000000",
  "event_type": "connected_account.disconnected",
  "occurred_at": "2025-01-01T00:00:00.000Z",
  "workspace_id": "00000000-0000-0000-0000-000000000000"
}

Properties

connected_account_custom_metadata

Object

Custom metadata of the connected account, present when connected_account_id is provided.

connected_account_errors

Array

Errors associated with the connected account.

connected_account_id

String (UUID)

ID of the affected connected account.

connected_account_warnings

Array

Warnings associated with the connected account.

created_at

String (ISO 8601)

Date and time at which the event was created.

event_description

String

Human-readable description of the event. Persisted when the event is created (so the creating code, including a provider, can supply a tailored description) and otherwise derived from the event.

event_id

String (UUID)

ID of the event.

event_type

Enum (String)

Value: connected_account.disconnected

occurred_at

String (ISO 8601)

Date and time at which the event occurred.

workspace_id

String (UUID)

ID of the workspace associated with the event.

`connected_account.completed_first_sync`

A connected account completed the first sync with Seam, and the corresponding devices or systems are now available.

{
  "connected_account_custom_metadata": {},
  "connected_account_id": "00000000-0000-0000-0000-000000000000",
  "created_at": "2025-01-01T00:00:00.000Z",
  "event_description": "A connected account completed the first sync with Seam, and the corresponding devices or systems are now available.",
  "event_id": "00000000-0000-0000-0000-000000000000",
  "event_type": "connected_account.completed_first_sync",
  "occurred_at": "2025-01-01T00:00:00.000Z",
  "workspace_id": "00000000-0000-0000-0000-000000000000"
}

Properties

connected_account_custom_metadata

Object

Custom metadata of the connected account, present when connected_account_id is provided.

connected_account_id

String (UUID)

ID of the affected connected account.

created_at

String (ISO 8601)

Date and time at which the event was created.

event_description

String

Human-readable description of the event. Persisted when the event is created (so the creating code, including a provider, can supply a tailored description) and otherwise derived from the event.

event_id

String (UUID)

ID of the event.

event_type

Enum (String)

Value: connected_account.completed_first_sync

occurred_at

String (ISO 8601)

Date and time at which the event occurred.

workspace_id

String (UUID)

ID of the workspace associated with the event.

`connected_account.deleted`

A connected account was deleted.

{
  "connected_account_custom_metadata": {},
  "connected_account_id": "00000000-0000-0000-0000-000000000000",
  "connected_account_type": "",
  "created_at": "2025-01-01T00:00:00.000Z",
  "customer_key": "",
  "event_description": "A connected account was deleted.",
  "event_id": "00000000-0000-0000-0000-000000000000",
  "event_type": "connected_account.deleted",
  "occurred_at": "2025-01-01T00:00:00.000Z",
  "workspace_id": "00000000-0000-0000-0000-000000000000"
}

Properties

connected_account_custom_metadata

Object

Custom metadata of the connected account, present when connected_account_id is provided.

connected_account_id

String (UUID)

ID of the affected connected account.

connected_account_type

String

undocumented: Unreleased.

created_at

String (ISO 8601)

Date and time at which the event was created.

customer_key

String

The customer key associated with this connected account, if any.

event_description

String

Human-readable description of the event. Persisted when the event is created (so the creating code, including a provider, can supply a tailored description) and otherwise derived from the event.

event_id

String (UUID)

ID of the event.

event_type

Enum (String)

Value: connected_account.deleted

occurred_at

String (ISO 8601)

Date and time at which the event occurred.

workspace_id

String (UUID)

ID of the workspace associated with the event.

`connected_account.completed_first_sync_after_reconnection`

A connected account completed the first sync after reconnection with Seam, and the corresponding devices or systems are now available.

{
  "connected_account_custom_metadata": {},
  "connected_account_id": "00000000-0000-0000-0000-000000000000",
  "created_at": "2025-01-01T00:00:00.000Z",
  "event_description": "A connected account completed the first sync after reconnection with Seam, and the corresponding devices or systems are now available.",
  "event_id": "00000000-0000-0000-0000-000000000000",
  "event_type": "connected_account.completed_first_sync_after_reconnection",
  "occurred_at": "2025-01-01T00:00:00.000Z",
  "workspace_id": "00000000-0000-0000-0000-000000000000"
}

Properties

connected_account_custom_metadata

Object

Custom metadata of the connected account, present when connected_account_id is provided.

connected_account_id

String (UUID)

ID of the affected connected account.

created_at

String (ISO 8601)

Date and time at which the event was created.

event_description

String

Human-readable description of the event. Persisted when the event is created (so the creating code, including a provider, can supply a tailored description) and otherwise derived from the event.

event_id

String (UUID)

ID of the event.

event_type

Enum (String)

Value: connected_account.completed_first_sync_after_reconnection

occurred_at

String (ISO 8601)

Date and time at which the event occurred.

workspace_id

String (UUID)

ID of the workspace associated with the event.

`connected_account.reauthorization_requested`

A connected account requires reauthorization using a new Connect Webview. The account is still connected, but cannot access new features. Delaying reauthorization too long will eventually cause the Connected Account to become disconnected.

{
  "connected_account_custom_metadata": {},
  "connected_account_errors": [],
  "connected_account_id": "00000000-0000-0000-0000-000000000000",
  "connected_account_warnings": [],
  "created_at": "2025-01-01T00:00:00.000Z",
  "event_description": "A connected account requires reauthorization using a new Connect Webview. The account is still connected, but cannot access new features. Delaying reauthorization too long will eventually cause the Connected Account to become disconnected.",
  "event_id": "00000000-0000-0000-0000-000000000000",
  "event_type": "connected_account.reauthorization_requested",
  "occurred_at": "2025-01-01T00:00:00.000Z",
  "workspace_id": "00000000-0000-0000-0000-000000000000"
}

Properties

connected_account_custom_metadata

Object

Custom metadata of the connected account, present when connected_account_id is provided.

connected_account_errors

Array

Errors associated with the connected account.

connected_account_id

String (UUID)

ID of the affected connected account.

connected_account_warnings

Array

Warnings associated with the connected account.

created_at

String (ISO 8601)

Date and time at which the event was created.

event_description

String

Human-readable description of the event. Persisted when the event is created (so the creating code, including a provider, can supply a tailored description) and otherwise derived from the event.

event_id

String (UUID)

ID of the event.

event_type

Enum (String)

Value: connected_account.reauthorization_requested

occurred_at

String (ISO 8601)

Date and time at which the event occurred.

workspace_id

String (UUID)

ID of the workspace associated with the event.

Getting Started

Granting Access

Devices and Systems

Setup

Monitoring

Low-Level APIs

Connected Account Events

`connected_account.connected`

`connected_account.created`

`connected_account.successful_login`

`connected_account.disconnected`

`connected_account.completed_first_sync`

`connected_account.deleted`

`connected_account.completed_first_sync_after_reconnection`

`connected_account.reauthorization_requested`

​connected_account.connected

​connected_account.created

​connected_account.successful_login

​connected_account.disconnected

​connected_account.completed_first_sync

​connected_account.deleted

​connected_account.completed_first_sync_after_reconnection

​connected_account.reauthorization_requested

`connected_account.connected`

`connected_account.created`

`connected_account.successful_login`

`connected_account.disconnected`

`connected_account.completed_first_sync`

`connected_account.deleted`

`connected_account.completed_first_sync_after_reconnection`

`connected_account.reauthorization_requested`