Configure Merge HRIS webhooks to trigger downstream HR workflows when employee data changes across connected payroll providers

Steps

1. In the Merge dashboard or via the Merge API, register a webhook URL and select the HRIS object types and change events you want to monitor (e.g., employee created, employment terminated, compensation updated)
2. Implement an HTTPS endpoint in your application to receive Merge webhook POST payloads; return HTTP 200 promptly to acknowledge receipt
3. Validate webhook signatures using the secret provided in the Merge dashboard to ensure payloads originate from Merge
4. Parse the webhook payload to extract the linked_account_id (to identify which employer's data changed), the object_type, the change_type, and the modified object data
5. Trigger your downstream workflow based on change type: e.g., provision accounts for new employees, revoke access on terminations, update compensation records in your people analytics DB
6. Handle the case where the full object is not included in the webhook — fetch the complete record from the Merge API using the object ID in the payload if you need additional fields