Discover: BambooHR

Create a custom webhook in Enboarder that you can use to add a new employee to the BambooHR employee database

Adam Faludi avatar
Written by Adam Faludi
Updated over a week ago

Want to make sending of data from Enboarder to BambooHR easier than ever? Good news! You can now directly add an employee from BambooHR to Enboarder! It's super convenient and saves you time.

So, here's the deal: you'll be using the BambooHR API through Enboarder's Send Data webhook. Don't worry; it's not as complicated as it sounds!

To create an employee record in Bamboo, you can gather the required data in Enboarder using either an integration or a form. In this guide, we'll show you how to do it using a pre-built form in Enboarder. But guess what? These steps can be applied to customize and populate a new employee with any data you prefer!

Follow along, and you'll be an expert in no time! 😄🎉

Funcional Requirements

  1. BambooHR admin access

    1. A subdomain to access your BambooHR account

    2. An API key

  2. Enboarder admin access


To populate a new employee in BambooHR, you will need to perform the following steps:

1. Generate an API Key in BambooHR

  1. Login to your BambooHR account.

  2. Navigate to the user-context menu.

  3. Select the API Keys option from the drop-down.

  4. From here you can add a new API key. Save the key somewhere you can reference it later

    Please Note: If you don’t have the “Add New Key” button, you may not have sufficient permissions. Contact BambooHR support.

2. Build a form to collect data

To create a new employee record in the BambooHR, the webhook must include at least a first and last name. All other fields must exist in BambooHR. You can find the full list of attribute names or “aliases” for each field you’d like to map to in BambooHR by executing the "Get a list of fields" API call.

Once you have decided on the fields you'd like to collect to create the new BambooHR profile, you can start creating the form. While building a form, it’s important to pay attention to the field types selected and the format of the field values that BambooHR will accept. For example, if “Hire Date” is a field in your form, BambooHR will only accept dates in the following format: YYYY-MM-DD so you may want to make a note of that in your form. Click here to read more about the supported file types in BambooHR.

Please Note: For fields with selectable options, we recommend using a dropdown menu to minimize the chance of errors during manual entry. The example below shows a field to collect the Department, in this example the four options are added to the dropdown. This way it can be guaranteed that an existing value in the correct format will be chosen rather than an open-text field where a person entering the data may incorrectly type “CS” instead of “Customer Success”.

3. Configure webhook in Enboarder

To configure a webhook in Enboarder you can utilize the Send Data webhook module and BambooHR’s open API.

  • API Endpoint - /api/gateway.php/{{companyDomain}}/v1/employees/
    ** Add your company domain name in the {companyDomain} section

  • Authentication: Standard Authentication
    **BambooHR does not offer OAuth2.0 at the time this article was written.

  • Method: POST

  • Headers - key: content-type value: application/json
    key: authorization value: {{HTTP Basic Authentication}}

** For HTTP Basic Authentication, go here. Input the API Key you saved in Step 1 into the “Basic: username” field. Leave the password field blank. The resulting string is encoded using a variant of Base64 with “Basic” prepended to the encoded string.

Sample Payload

Example Webhook

The same steps can be applied to populate a new employee with the data of your choosing from Enboarder!

Did this answer your question?