BambooHR
Connect BambooHR with a read-only API key that is stored encrypted, pick employees from your directory, and invite them in bulk.
If your organisation runs BambooHR, you can invite people straight from its employee directory instead of typing names and emails. The app only reads from BambooHR. It never writes anything back.
Connect BambooHR
Section titled “Connect BambooHR”First create an API key in BambooHR: open the menu under your avatar and choose API Keys. The key only needs permission to read the employee directory.
- In the app, open BambooHR.
- Enter your BambooHR subdomain: the part before
.bamboohr.com. Fornorthwind.bamboohr.comit’snorthwind. - Paste the API key.
- Select Connect BambooHR.
The app checks the key against BambooHR before saving it, and the message says how many employees it found. If BambooHR refuses the key or doesn’t know the subdomain, the message says which, and nothing is saved. The subdomain stays in the form; enter the key again.
The key is stored encrypted, under a key of its own that only the app holds, and is never shown again, to you or anyone else. Once connected, the page shows the subdomain, when you connected, and when the directory was last read.
- Test the connection reads the directory with the stored key and says how many employees it found.
- Disconnect deletes the key. People you’ve already invited stay, with their training.
If the stored key stops working, for example because it was revoked in BambooHR, the page says why it couldn’t read the directory and offers Connect again with a form to enter a new key.
Invite people from the directory
Section titled “Invite people from the directory”The app reads your directory from BambooHR every time you open the page, so it’s always current. Each employee has a status:
| Status | What it means | Can you select them? |
|---|---|---|
| Not onboarded | Nobody in your organisation matches them | Yes |
| Invited | Invited, hasn’t set a password yet | No |
| Active | Has an account and has signed in | No |
| Deactivated | Had an account that’s been deactivated | No |
| No work email | BambooHR has no work email for them | No |
Employees are matched to your people by their BambooHR ID, then by work email, within your organisation only.
- Find people with the filter, which searches name, email and department, or tick the box in the header to select everyone not yet onboarded.
- Select Invite. The button says how many people you’re inviting.
Up to 100 people at a time. Everyone selected gets an invite email, all in one step. The message afterwards says how many were invited and how many were skipped because their status changed since you opened the page.
People invited from BambooHR carry a BambooHR tag on the People page. To give them courses, assign them from People like anyone else.
What it doesn’t do yet
Section titled “What it doesn’t do yet”The connection works when you open the page. New hires appear in the directory as Not onboarded until you invite them, and people who leave aren’t deactivated for you. Deactivate leavers from People.