Webhooks

This guide provides instructions on creating a webhook in BambooHR for monitoring changes to specific fields. Users can select which fields to monitor, and BambooHR will post the information to a designated URL. To set up a webhook, navigate to Settings > Account > Webhooks and click +Add Webhook. Users must name the webhook, select fields for monitoring and posting, choose the data format, and provide a URL for posting data changes. A developer's assistance is required for the URL setup. Additionally, a private signature key can be generated for security, which is only available at the time of creation. After configuration, users should save the webhook to activate it. Changes to monitored fields will trigger notifications.

  • Jul 8, 2026
  • Knowledge

Title
Webhooks
Article Text
This feature is included in the Core, Pro, and Elite packages.

How do I create a webhook?

Purpose: This guide will teach you how to create a webhook in BambooHR that allows you to monitor changes to specific fields.

Webhooks allow you to monitor changes to a specific list of fields. You can choose which fields you want to monitor. BambooHR will post the information to a provided URL, and you will need help from a developer at your company to set up a webhook.

You can learn more about webhooks here.

Add a webhook

Webhooks

To create a webhook, navigate to Settings > Account > Webhooks and then click +Add Webhook.

Add Webhook
  1. Webhook Name: Name the webhook.
  2. What fields do you want to monitor?: Select which fields you would like to monitor with this webhook.* Only the fields in this list are available for monitoring with webhooks.
  3. What fields do you want to post?: Select which fields you would like to post along with your webhook. For example, you may want to post an employee's employee # or their name with the fields you are monitoring to make it easier for you to keep track of the changes.
  4. What format should the data be in?: Select which format you would like the data to be in.
  5. Post to URL: This step requires a developer on your end to create a URL for posting the data changes.
  6. Private Signature Key: Click +Generate Key to create a private signature key you can save and use to verify that the webhook came from BambooHR. When using a private signature key, the webhook is secured using SHA-256 HMAC.
    • NOTE: You can only copy this key at the point it is generated. Once you save the webhook, it is no longer available to view, and if lost, you will need to regenerate it. Click COPY KEY for safekeeping.

After setting up the webhook, click Save to create the webhook.

*A change that occurs to one of the monitored fields will automatically prompt the webhook to notify you of the change.

URL Name
787428