BamBoo HR - Creating an API Link
There are three steps that need to take place within BamBoo HR before we can link to your system.
- Determine User Access
- Create a new Non-Employee User
- Generate an API Key
Determine User Access
Start this process by creating a custom access level that only includes access to the fields needed for the integration. A created API key will have the same amount of access as the user who created it. When first setting up the custom access level, the API key will not have access to information more than necessary.
Create a new Non-Employee User
The reason why you create a new user is that it allows you control who has access via an API.
Go to the specific custom access level and select Add a Non-Employee User from the action menu. You can then enter the first name, last name, and email address of the user. Once you create the user, you can assign them to the custom access level. If necessary, you can create an email alias for the integration to connect to your original email address. For example, your regular email address is pandabear@bamboohr.com, and you want to create a non-employee user with the same address, you can use an email alias such as pandabear+integration@bamboohr.com.
Create the API Key
Using the profile of your new Non-Employee User



The API key will only appear during the process of creation. If you do not copy or
have misplaced the key, you will need to create a new key. Please note that
BambooHR cannot retrieve the key because it is encrypted within our system for
security purposes. Send the key to setups@paymasters.co.nz
