Add BambooHR to Zoho One | Admin Guide - Zoho One

Add BambooHR to Zoho One

Prerequisites

Roles required in Zoho One to perform this action:
  1. Organization Owner
  2. Organization Admin
Roles required in BambooHR:
  1. Admin
Plan dependency in Zoho One:
  1. Free plan

In BambooHR:

  1. Log in to your BambooHR account.
  2. Click the My Account icon in the bottom-left corner and click API Keys.



  3. As an API key generated in BambooHR can only be used once, to create a new one, click Add New Key.
  4. Enter an API Key Name and click Generate Key.


  5. Copy the generated key, as you will need to paste it during the BambooHR configuration in Zoho One.
  6. Click Done, once you have copied the key.

In Zoho One:

Spaces UI
Unified UI
Spaces UI
  1. Sign in to Zoho One, then click  in the top-right corner.
  2. Go to Directory Stores, then click Add Directory.
  3. Click Add next to BambooHR.
  4. On the API Integration page, enter the domain name and the API key copied from your BambooHR account.
    Info
    For example, if your login URL is "https://mycompany.bamboohr.com", then your BambooHR company's domain name is 'mycompany'.



    5. Notes
    Make sure to authenticate this page without any errors.
  5. Click Next.
    6. Info
    If your custom attribute in BambooHR is "test value", you should enter the value with a prefix custom and without any spaces. As per the format, the input value is customtestvalue.
  6. Click Save and Next.
  7. In the General Settings section, under Mail Notification, you can choose whether users and admins can receive email notifications related to this integration. These mails include workflow notifications, user invitation mails, app account access notifications, delete/deactivate notifications, and conditional assignment notifications. Learn more about General settings section
  8. If Notify via mail is selected, the Password Notification section appears, where you can choose how newly synced users will receive their one-time password.
    Notes
    Password Notification setting is only available to users' whose email address has a verified domain name. If you want to include users whose email address is from an unverified domain, then verify the domain and come back to continue.
  9. Under the Status Sync section, choose what should happen in Zoho One when users get activated, deactivated, and deleted in the required store.
  10. Click Save and Next.
  11. Choose how you want to sync users from BambooHR. You can either sync all the users or a few users based on criteria in Zoho One. You can use custom attributes to set criteria. You can also set multiple criteria based on your needs using the + icon. Learn more about configuring Criteria
  12. Click Save and Next.
  13. Enable Schedule Sync to import users from BambooHR automatically at a specified time interval. Choose whether the sync should run on a Daily, Weekly, or Monthly basis, and set the preferred time. Learn more about Schedule sync
  14. Click Save and close.
  15. Under IMPORT USERS, all users (except deleted users) will be fetched and shown depending on the chosen criteria. Select the required users and click Import. The import summary will be displayed upon completion, click Finish. If you select more than 200 users, users will be staged, and it might take time to list the users.
  16. Once imported, you can view the users' list in the Members menu.
Info
The Import Users lets you manually sync users at any time, whereas the Schedule Sync automates the process by running user syncs at scheduled intervals.
Unified UI
  1. Sign in to Zoho One, then click Directory in the left navigation menu.
  2. Go to Directory Stores, then click Add Directory.
  3. Click Add next to BambooHR.
  4. On the API Integration page, enter the domain name and the API key copied from your BambooHR account.
    Info
    For example, if your login URL is "https://mycompany.bamboohr.com", then your BambooHR company's domain name is 'mycompany'.



    5. Notes
    Make sure to authenticate this page without any errors.
  5. Click Next.
  6. Map the fields available in Zoho One to the fields available in BambooHR.
    Info
    If your custom attribute in BambooHR is "test value", you should enter the value with a prefix custom and without any spaces. As per the format, the input value is customtestvalue.
  7. Click Save and Next.
  8. In the General Settings section, under Mail Notification, you can choose whether users and admins can receive email notifications related to this integration. These mails include workflow notifications, user invitation mails, app account access notifications, delete/deactivate notifications, and conditional assignment notifications. Learn more about General settings 
  9. If Notify via mail is selected, the Password Notification section appears, where you can choose how newly synced users will receive their one-time password. 
    Notes
    Password Notification setting is only available to users' whose email address has a verified domain name. If you want to include users whose email address is from an unverified domain, then verify the domain and come back to continue.
  10. Under the Status Sync section, choose what should happen in Zoho One when users get activated, deactivated, and deleted in the required store.
  11. Click Save and Next.
  12. Choose how you want to sync users from BambooHR. You can either sync all the users or a few users based on criteria in Zoho One. You can use custom attributes to set criteria. You can also set multiple criteria based on your needs using the + icon. Learn more about configuring Criteria 
  13. Click Save and Next.
  14. Enable Schedule Sync to import users from BambooHR automatically at a specified time interval. Choose whether the sync should run on a Daily, Weekly, or Monthly basis, and set the preferred time under the Time section. Learn more about Schedule sync
  15. Click Save and close.
  16. Under IMPORT USERS, all users (except deleted users) will be fetched and shown depending on the chosen criteria, Select the required users and click Import. The import summary will be displayed upon completion, click Finish. If you select more than 200 users, users will be staged, and it might take time to list the users.  
  17. Once imported, you can view the users' list in the Members menu.
Info
The Import Users lets you manually sync users at any time, whereas the Schedule Sync automates the process by running user syncs at scheduled intervals.