BambooHR is an HRMS (Human Resources Management System) for small and medium-sized businesses to manage employee information and lifecycles.
Set Up API Credentials
Whenever you're adding an integration for your HRMS (sensitive data ahead!) best practice is to give that integration access only to information it needs (see below example). As a BambooHR administrator you can easily do this by setting up a Custom Access Level and then setting up a non-Employee User (e.g. Beekeeper Integration) for which you can then create an API Key by logging-in as that non-employee user and selecting API Keys from the Profile Picture drop-down in the top-right.
Please make sure that all fields you'd like to have in Beekeeper are on View Only in the custom access level you've setup in BambooHR.
From the side of Beekeeper we require at least the following four attributes (View Only) from BambooHR to set up the integration.
- Employee #
- First Name
- Last Name
Finally, share the following information with your Customer Success Manager over a secure channel:
- Company ID: the name ID of your company in BambooHR - it can be found in the URL
- API token: a valid API key, which can be found under User > API Keys