Skip to main content
Subscribe to these events via Webhooks to receive notifications when employment data becomes available or changes during a refresh. All webhook payloads include the common fields plus the event-specific fields below.

​
employment-created

Fires when employment data has been extracted. This occurs once per Link for each non-refresh Task completion. Multiple responses are sent when additional employments are found. Additional fields:
FieldDescription
object_idThe employment record ID
task_idThe associated Task
tracking_infoCustom metadata passed via bridge_token (nullable)
{
  "webhook_id": "984e2cf9b69e4bc29acea714f1d5a554",
  "task_id": "c32fb957ec7246828da56be7516da765",
  "link_id": "9915c50cc047413bb810767f218390f8",
  "product": "employment",
  "data_source": "payroll",
  "tracking_info": null,
  "event_type": "employment-created",
  "event_created_at": "2022-08-23T17:32:19.307951Z",
  "object_id": "427abebd8590457e8332fdff77fc412f",
  "user_id": "88fef4cea64c40b5ad6727cc9b0b9fdc",
  "template_id": null
}

​
employment-updated

Fires when employment data has changed during a refresh Task. Additional fields: Same as employment-created (object_id, task_id, tracking_info). 
{
  "webhook_id": "984e2cf9b69e4bc29acea714f1d5a554",
  "task_id": "c32fb957ec7246828da56be7516da765",
  "link_id": "9915c50cc047413bb810767f218390f8",
  "product": "employment",
  "data_source": "payroll",
  "tracking_info": null,
  "event_type": "employment-updated",
  "event_created_at": "2022-08-23T17:32:19.307951Z",
  "object_id": "427abebd8590457e8332fdff77fc412f",
  "user_id": "88fef4cea64c40b5ad6727cc9b0b9fdc",
  "template_id": null
}