If any of the screenshots below don’t match what you’re seeing, please contact support.


You’re going to follow a 4 step process:

  1. Create a new access level in BambooHR

  2. Create a new non-employee BambooHR user with that access level

  3. Create an API key for that user

  4. Give Blissbook the information it needs to fetch that API key

You're doing steps 1 & 2 because you might leave your company some day and this prevents everything from breaking when you leave. If you’re never going to leave your company, you can skip right to step 3.

Pay attention to the pink boxes in the screenshots below!

Step 1. Create a new Custom Access Level

You'll be giving your new user this access level. After you sign in to BambooHR, click Settings in the top right:

Then click Access Levels in the gray left menu [1], then the +/lock icon next to “Levels” [2], then Custom Access Level [3]:

Name your new access level:

Skip this step by clicking Next Step (Blissbook does not need edit access to anything):

Give Blissbook View Only access to all Personal data [1], then click Job [2]:

Grant Blissbook View Only access to Hire Date [1], Original Hire Date [2], Employment Status [3], and Job Information [4], then click Save and Finish [5]:

2. Create a New Non-Employee User

Next we will add a non-employee user using the access level you just created (Blissbook).

Enter a name and email address you will remember [1, 2, 3], choose the “Blissbook” Access Level that you just created [4, 5], and click Save [6].

Special Email Address Note:

You must be able to receive email at the email address you use so you can set your password.

You cannot use an existing employee email address (including yours).

Some email servers (gmail is one) allow you to add a “+” and a string of characters to your current email address to create an alias… such as: youremail+text@yourdomain.com.

Other options:

  • Use a group email address like hr@yourdomain.com

  • Have your IT dept. create a new email address for you

  • Create a free gmail/yahoo/etc. account

  • If all else fails, contact us for help at support@blissbook.com

Write down this email address!

Within a few minutes, you will receive an email that looks like this. Click the Choose Your Password link:

When the page loads, choose your password and don’t forget to write it down!

3. Create Your API Key

Log Out of BambooHR:

Log In to BambooHR as the new user you just created:

Go to the API Keys section of BambooHR:

Click the “+ Add a New Key” button to create a new API key:

4. Enable Your Integration in Blissbook

Go to the Sync tab of your People page in Blissbook (click ORGANIZATION in the main nav, then choose the SYNC tab) and click the Connect button next to "Via a BambooHR Integration".

Enter your account subdomain and the Login Information using the non-employee BambooHR user you created in step 1, then click the Install BambooHR button.

Eat a whole box of Oreos because you’re done!

Did this answer your question?