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 - Fires when a person has been created.
- Person Deleted Event - Fires when a person has been deleted.
- Person Updated Event - Fires when a person has been updated.
- Person Birthday Upcoming Event - Fires 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 - Fires when a job has been created.
- Job Deleted Event - Fires 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 Anniversary Upcoming Event - Fires at set offsets before and including the job anniversary 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 - Fires when an update has been scheduled for a job.
- Job Timeline Updated Event - Fires on the day when an update of the job has taken effect. Eg. if a job update is scheduled for March 31, 2025, this event will fire on March 31, 2025. Similarly, if there is a job update on the present date, this event will also fire.
- Job Remuneration Update Scheduled Event - Fires when an update has been scheduled for a job's remuneration. Eg. if a remuneration update is scheduled for March 31, 2025, this event will fire on March 31, 2025. Similarly, if there is a remuneration update on the present date, this event will also fire.
- Job Onboarding Payroll Completed Event - Fires when payroll onboarding for a job has been completed.
- Job Ended Event - Fires when the job has ended.
- Job End Date Finalised - Fires when the job end date has been finalised.
- Job End of Job Cancelled Event - Fires when a job end date that had been finalised is 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 - Fires at set offsets before the user account is scheduled to be disabled.
- User Created Event - Fires when a user account has been created.
- User Disabled Event - Fires when a user account has been disabled.
- User Updated Event - Fires when a user account has been updated.
- User Deleted Event - Fires when a user account has been deleted.
- Training Created Event - Fires when a training record is created.
- Training Deleted Event - Fires when a training record has been deleted.
- Training Updated Event - Fires when a training record has been updated.
- Form Created Event - Fires when an instance of a form has been created.
- Form Completed Event - Fires when an instance of a form has been completed.
- Qualification Instance Created - Fires when a qualification instance has been created.
- Qualification Instance Updated - Fires 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.