Humanforce HR Webhooks provide a method for distinct web applications in your tech ecosystem to communicate with each other. The webhooks allow you to send real-time data from one application, such as Humanforce HR to another, such as your payroll software or middleware, such as Zapier. This article is designed for you to share with your IT team/developers to explain webhooks specific to Humanforce HR and highlight the webhooks that can be subscribed to through the platform.
This article covers:
- Humanforce HR Webhook Functionality
- Webhooks that can be subscribed to
- Using Humanforce HR Webhooks
- IP Allowlisting for webhooks
- Debugging
Humanforce HR Webhook Functionality
The webhooks area within Humanforce HR allows you to create and debug webhooks.
Webhooks are used in the system to allow developers and integration platforms (such as Zapier) to subscribe to a Webhook Event, such as a person.updated or person.created event.
When the Webhook Event is triggered, the system will send this information (referred to as a payload) to the target destination specified when creating the Webhook.
For example, you can configure middleware such as Zapier to subscribe to an event such as person.created and then set subsequent actions via that middleware, such as email notifications and person creation in your other software.
It is also possible to subscribe to the Humanforce HR events to trigger action in other parts of your tech ecosystem via the public API.
Webhooks that can be subscribed to within Humanforce HR
- Person Created Event - Fired when a person has been created.
- Person Deleted Event - Fired when a person has been deleted.
- Person Updated Event - Fired when a person has been updated.
- Person Birthday Upcoming Event - Fired at certain intervals before a person's birthday and on the date of their birthday. Intervals are 1 month before, 14 days before, 7 days before, 3 days before, 1 day before and on the day of.
- Job Created Event - Fired when a job has been created.
- Job Deleted Event - Fired when a job has been deleted.
- Job Company Start Date Upcoming Event - Fires at set offsets before and including the job company start date. Intervals are 1 month before, 14 days before, 7 days before, 3 days before, 1 day before and on the day of.
- Job Update Scheduled Event - Fired when an update has been scheduled for a job.
- Job Timeline Updated Event - Fired on the day when an update of the job has taken effect. Eg. if a job update is scheduled for 31/03/2025, this event will fire on 31/03/2025. Similarly, if there is a job update on the present date, this event will also fire.
- Job Remuneration Update Scheduled Event - Fired when an update has been scheduled for a job's remuneration.
- Job Onboarding Payroll Completed Event - Fired when payroll onboarding for a job has been completed.
- Job Ended Event - Fired when the job has ended.
- Job End Date Finalised - Fired when the job end date has been finalised.
- Job End of Job Cancelled Event - Fired when a job end date that had been finalised (was cancelled).
- Job Effective Dates Updated Event - Fires when the effective dates of the job have been updated.
- Job End of Job Adjusted Event - Fires when the job end date has been adjusted, but before being finalised.
- User Disabled Upcoming Event - Fired at set offsets before the user is scheduled to be disabled.
- User Created Event - Fired when a user has been created.
- User Disabled Event - Fired when a user has been disabled.
- User Updated Event - Fired when a user has been updated.
- User Deleted Event - Fired when a user has been deleted.
- Training Created Event - Fired when a training is created.
- Training Deleted Event - Fired when a training has been deleted.
- Training Updated Event - Fired when a training has been updated.
- Form Created Event - Fired when an instance of a form has been created.
- Form Completed Event - Fired when a instance of a form has been completed.
- Qualification Instance Created - Fired when a qualification instance has been created.
- Qualification Instance Updated - Fired when a qualification instance has been updated.
Using Humanforce HR Webhooks
1. Navigate to Settings > All Settings > Webhooks
2. Create Webhook
3. Select the Event you wish to subscribe to and the URL you wish to send that payload
4. Submit
IP Allowlisting for Webhooks
Humanforce HR uses the following IP ranges to send webhooks from:
For customers based in EU and NA:
54.74.150.228/32
54.73.108.157/32
54.246.31.155/32
All other customers:
54.66.48.1/32
54.79.136.162/32
54.253.224.28/32
Debugging
From the webhooks area on Humanforce HR developers can View Logs of the webhook(s) you are subscribing to and Replay if required.