Account Link Webhook Events

Subscribe to these events via Webhooks to track Account Link state changes in real time. All webhook payloads include these common fields:

Field	Description
`webhook_id`	Unique identifier for this webhook request
`event_type`	The event classification
`event_created_at`	Timestamp when the event occurred
`user_id`	Associated Truv user identifier

All Account Link events on this page also include these fields:

Field	Description
`link_id`	The Link identifier
`product`	The product the event relates to, such as `income`, `employment`, or `assets`
`data_source`	Source of data: `payroll`, `docs`, `insurance`, `financial_accounts`, or `tax`
`tracking_info`	Custom metadata passed via `bridge_token` (nullable)

link-connected

Fires when a Link connection is successfully established.

{
  "webhook_id": "e5f6a7b8c9d0e1f2a3b4c5d6a7b8c9d0",
  "event_type": "link-connected",
  "event_created_at": "2022-08-24T13:54:00.000000Z",
  "link_id": "d39d86dcc20c46e0ae75ba9ab1311a21",
  "product": "income",
  "data_source": "payroll",
  "tracking_info": null,
  "user_id": "88fef4cea64c40b5ad6727cc9b0b9fdc"
}

link-disconnected

Fires when a Link connection fails during a refresh task.

{
  "webhook_id": "f6a7b8c9d0e1f2a3b4c5d6a7b8c9d0e1",
  "event_type": "link-disconnected",
  "event_created_at": "2022-08-25T09:31:00.000000Z",
  "link_id": "d39d86dcc20c46e0ae75ba9ab1311a21",
  "product": "income",
  "data_source": "payroll",
  "tracking_info": null,
  "user_id": "88fef4cea64c40b5ad6727cc9b0b9fdc"
}

link-deleted

Fires when personal data and credentials are removed from a Link.

{
  "webhook_id": "a7b8c9d0e1f2a3b4c5d6a7b8c9d0e1f2",
  "event_type": "link-deleted",
  "event_created_at": "2022-08-26T10:00:00.000000Z",
  "link_id": "d39d86dcc20c46e0ae75ba9ab1311a21",
  "product": "income",
  "data_source": "payroll",
  "tracking_info": null,
  "user_id": "88fef4cea64c40b5ad6727cc9b0b9fdc"
}

​link-connected

​link-disconnected

​link-deleted

link-connected

link-disconnected

link-deleted