Identity Webhook Events

Subscribe to these events via Webhooks to receive notifications when identity data becomes available or changes during a refresh. 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 Identity events on this page also include these fields:

Field	Description
`link_id`	Identifier of the Link
`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)
`task_id`	The associated Task
`object_id`	The identity profile record ID

profile-created

Fires when identity and profile information has been extracted. This occurs once per Link for each non-refresh Task completion.

{
  "webhook_id": "81e4552a215d4f4695bc6fae2675aeee",
  "task_id": "c32fb957ec7246828da56be7516da765",
  "link_id": "9915c50cc047413bb810767f218390f8",
  "product": "employment",
  "data_source": "payroll",
  "tracking_info": null,
  "event_type": "profile-created",
  "event_created_at": "2022-08-23T17:32:19.295569Z",
  "object_id": "25d588c7cc1c43178375bdc1bc9852ac",
  "user_id": "88fef4cea64c40b5ad6727cc9b0b9fdc"
}

profile-updated

Fires when identity and profile information has changed during a refresh Task.

{
  "webhook_id": "81e4552a215d4f4695bc6fae2675aeee",
  "task_id": "c32fb957ec7246828da56be7516da765",
  "link_id": "9915c50cc047413bb810767f218390f8",
  "product": "employment",
  "data_source": "payroll",
  "tracking_info": null,
  "event_type": "profile-updated",
  "event_created_at": "2022-08-23T17:32:19.295569Z",
  "object_id": "25d588c7cc1c43178375bdc1bc9852ac",
  "user_id": "88fef4cea64c40b5ad6727cc9b0b9fdc"
}

​profile-created

​profile-updated

profile-created

profile-updated