BambooHr is an HRIS solution for the mid-market.

Fountain is able to push applicants and their data to BambooHR when they are hired/contracted with the help of some middleware.

 

Steps to Integrate

You need to accomplish several steps to ensure a successful integration

  1. Retrieve the list of your BambooHR account fields
  2. Build middleware that allows you to connect your Fountain fields to BambooHR
  3. Push Fountain applicants and data to middleware to be mapped to BambooHR
  4. Map Fountain applicant data to BambooHR account fields

 

Retrieve BambooHR Account Field List

BambooHR’s API docs that allows users to fetch their list of applicant fields. Here's a link to that method.

We recommend you use Postman - a fantastic free service to help test APIs - to create a GET request. Remember to authenticate the GET request (At the HTTP level, the API key is sent over HTTP Basic Authentication. Use the secret key as the username and any random string for the password.)

A successful response for your account field GET request should look something like this:

 

 

Notice now that there are actually two types of fields, the "field id" and the "alias", and each field has a type, as well.

In the example above, BambooHR will accept data pointing towards either the field id (1) or the alias (firstName), but not something like "First name".

Each field type will restrict what data can be pushed to that field. Here's more on BambooHR field type.

Keep this in mind, as these details will be important.

 

Set Up Middleware

 

Now that you have a list of all the fields that your BambooHR account has, you now have to build the middleware to map Fountain fields to BambooHR fields.

We recommend Zapier as our middleware service of choice, as it makes it really easy to map fields from one service to another (beyond just BambooHR or Fountain).

After you make an account, you can make a Zap. In this particular case, you'll want to create a Zap with a webhook for the "Trigger" with the option, "Catch Hook" and a second webhook for the "action

Setup Result
   

 

Great! That's it for setting it up. Now let's dive into pushing some data into here.

 

Push Fountain Data into Middleware

In the Catch Hook Trigger on Zapier, we're going to use this space to catch incoming webhooks from Fountain.

In Fountain, please navigate to Company Settings, then click "API." If you do not have access to the webhooks or API section, please ask your account admin(s) or owner(s) to grant you access under user permissions.

In this section, you are able to add a webhook. Please copy the Catch webhook that Zapier provides you and paste it into Fountain like below. 

Please add the same webhook for wherever applicants should be approved (select the position, then the stage at which the applicant should be added to BambooHR).

 

On Zapier, skip the child key section, and press "Ok, I did this."

Immediately return to Fountain and move a fully-completed (all the data is there from the application + data collection forms)

Add an applicant into that position and the webhook should fire from Fountain to Zapier.

If you see the following result screen, those Fountain stages are connected to Zapier!

Setup Result

Now click "Continue" and we'll set up the mapping on the next step.

 

Map Fountain data to BambooHR fields

Do you remember in the step 1 how we pulled every field from your BambooHR account? Now we need to map all the incoming Fountain.

This is when the "field id" and "alias" become important.

In the custom webhook action in Zapier, we're going to be mapping to the BambooHR method to add an employee.

Let's begin with the top part of the Zap. Change the Method of delivery to POST and paste in "https://api.bamboohr.com/api/gateway.php/{YOUR_ACCOUNT_NAME}/v1/employees/" in the URL. Leave data pass-through blank.

Now is the fun part, where we map the fields.

To start, with, add this snippet from the BambooHR documentation into the Data section:

<employee>   
    <field id="firstName">John</field
    <field id="lastName">Doe</field>
</employee>

Next, replace "John" with the first name that Fountain passed over using the upper right merge key tool.

Do the same for "Doe" and the last name.

Next, do the same for the remaining Fountain fields that you want to add to the BambooHR applicant profile. The only difference is each "field id" should be exactly what the alias is for the field from BambooHR in step 1.

Here's an example of what a completed webhook looks.

 

At the end, please add authentication.

 

After all of this is done, go ahead and test. Now, every applicant who lands on that stage will have a BambooHR employee profile!

 

 

Was this article helpful?
0 out of 0 found this helpful

Comments

0 comments

Please sign in to leave a comment.