Skip to main content
Subscribe to these events via Webhooks to receive notifications when bank account data becomes available or changes during a refresh. All webhook payloads include these common fields:
FieldDescription
webhook_idUnique identifier for this webhook request
event_typeThe event classification
event_created_atTimestamp when the event occurred
user_idAssociated Truv user identifier
All Bank Account events on this page also include these fields:
FieldDescription
link_idIdentifier of the Link
productThe product the event relates to, such as income, employment, or assets
data_sourceSource of data: payroll, docs, insurance, financial_accounts, or tax
tracking_infoCustom metadata passed via bridge_token (nullable)
task_idThe associated Task
employment_idThe associated employment record
objects_countNumber of bank accounts retrieved

​
bank-accounts-created

Fires when bank account data has been retrieved. This occurs once per Link for each non-refresh Task completion. Multiple responses are sent when additional bank accounts are found. 
{
  "webhook_id": "3cc6a3e58cbe4b71bbbe8b821d2242b8",
  "task_id": "c32fb957ec7246828da56be7516da765",
  "link_id": "9915c50cc047413bb810767f218390f8",
  "product": "employment",
  "data_source": "payroll",
  "tracking_info": null,
  "event_type": "bank-accounts-created",
  "event_created_at": "2022-08-23T17:32:19.269355Z",
  "objects_count": 2,
  "employment_id": "427abebd8590457e8332fdff77fc412f",
  "user_id": "88fef4cea64c40b5ad6727cc9b0b9fdc"
}

​
bank-accounts-updated

Fires when the bank account count changes during a refresh Task. For example, if a person had 3 bank accounts and now has 4. 
{
  "webhook_id": "3cc6a3e58cbe4b71bbbe8b821d2242b8",
  "task_id": "c32fb957ec7246828da56be7516da765",
  "link_id": "9915c50cc047413bb810767f218390f8",
  "product": "employment",
  "data_source": "payroll",
  "tracking_info": null,
  "event_type": "bank-accounts-updated",
  "event_created_at": "2022-08-23T17:32:19.269355Z",
  "objects_count": 2,
  "employment_id": "427abebd8590457e8332fdff77fc412f",
  "user_id": "88fef4cea64c40b5ad6727cc9b0b9fdc"
}