BambooHR API Integration

Note: BambooHR API does not provide access levels (aka permissions). It is only capable of sending employee data. We therefore recommend:

  • Use ZUS to sync account permissions as documented here

  • Use the API integration to sync BambooHR as a directory

  • To sync BambooHR as a directory AND also sync account permissions, create two separate application instances within Zilla.

Get the API Key and Subdomain

  • Visit your profile on BambooHR.

  • Copy the Subdomain only from the address bar of the home page of BambooHR for a later step. (Example: If your URL is https://zillasecurity.bamboohr.com/home then the Subdomain will be zillasecurity).

  • Click on the avatar section on the top right corner of the page and then click API Keys.

     

     

  • You will be redirected to the My API Keys page. Click on Add New Key.

     

     

  • Fill in the form with appropriate details and click Generate Key.

     

     

  • Copy the API Key for a later step. Click Done.

     

     

Note: Make sure you have copied the API Key as it cannot be retrieved once you have clicked Done.

Set up BambooHR Application Integration on Zilla:

  • Login to Zilla application using your admin credentials.

     

     

  • Click Add Application in the top right.

     

     

  • A window with a search bar appears, type in bamboohr in the search bar. BambooHR application entry will appear at the top of the list, click Add to Applications button to the right.

     

     

  • Fill in the form with appropriate details and then click Add to Applications button.

     

     

  • You will be redirected to the BambooHR application instance’s Profile tab. Click Sync now in the top right corner.

     

     

  • Enable the API Integration option from the dialog and fill in the details that have been saved in previous steps. Click Sync Now.

     

     

     

  • Click Next.

     

     

  • Click Done.

     

     

  • After successful sync, you will see the sync summary. Click Close.

     

     

  • Sample screenshot of the Accounts tab.