1. Create an API key in BambooHR
A user in the client’s BambooHR does these steps. Every call Neo makes runs with that user’s BambooHR access level, so Neo sees and changes only what the user can.1
Pick the user
Use a BambooHR user who can see the employees and fields your agents work with, such as a user with full admin access, or a dedicated user for Neo with a custom access level. To have Neo write back a work email, the user’s access level must allow editing it.
2
Create the key
Signed in as that user, click the user’s name in the lower left corner of BambooHR, then API Keys, and add a key named
Neo. Copy the key when BambooHR shows it.3
Find the company domain
The company domain is the part before
.bamboohr.com in the client’s BambooHR address. For https://acme.bamboohr.com, it is acme.2. Add the connection in Neo
1
Open Integrations
In the Neo Dashboard, open Integrations → BambooHR, under HR & Business Apps.
2
Pick the client
In Customer, choose the client this BambooHR company belongs to. The client must be on your Companies tab. For a second client, click Add customer.
3
Save the connection
Enter the Company Domain and the API Key, and click Save settings. Neo reads the client’s BambooHR field list with the key before it saves, so a wrong value is rejected straight away, with what to fix.
3. Turn BambooHR on per agent
1
Open the agent's tools
Open the agent in the Neo Dashboard, go to its Tools & Settings tab and click HR & Business Apps.
2
Pick a preset
Expand the BambooHR block and pick one of its Presets, or set each permission group by hand.
Read Only, Helpdesk and IT Admin keep Personal Details, Compensation & Benefits, Files and Reports & Datasets off. Turn one on only for an agent that needs it.
