Overview
Webhook events that occur during employment data operations. These webhooks notify systems when employment information is created or updated through the Transcrypts API.Employment Created
Event Type:employment-created
This webhook triggers upon successful employment creation. It fires once per Link for each non-refresh Task completion. Additional webhooks may be sent when discovering multiple employments for a single connection.
Example Payload
Employment Updated
Event Type:employment-updated
This webhook is triggered following completion of refresh Tasks, indicating that existing employment information has been refreshed or modified.
Example Payload
Common Webhook Fields
| Field | Description |
|---|---|
webhook_id | Unique identifier for the webhook |
task_id | Associated task identifier |
link_id | Connection identifier |
product | Data category (“employment”) |
data_source | Origin system (“payroll”) |
event_type | Webhook event classification |
event_created_at | ISO timestamp of event occurrence |
object_id | Employment record identifier |
template_id | Optional customization template reference |