BambooHR users create API keys, and API keys inherit the permission set of the user. If a user doesn't have access to a set of employees or particular field, then the API key won't have permissions to that either.

If you are seeing missing fields, the first thing to check is who created the API key. If the key was created by an employee, not an admin, they can only grant permissions for other employees, so some of their own fields might come back blank.

In this event, the BambooHR admin on the account will have to modify the permissions so that they can access their own information!

Refer to our help center articles on BambooHR authentication:

If you notice a missing field for a particular record, for example a single employee's job title, a good place to begin troubleshooting is with logs!

Go to your Merge Dashboard -> Linked Accounts and select the linked account

Click Logs

BambooHR requires you to request the fields that you want to pull from BambooHR explicitly. For each request we make to BambooHR, we put in the requested fields in the query parameter. The list of fields can be found here: https://documentation.bamboohr.com/docs/list-of-field-names

Going back to our example, let's say we are looking at why an employee's job title is not populating.

The employee's ID in BambooHR is 1800.

Using BambooHR docs from above I have found that the field corresponding to an employee's job title is "jobTitle".

I can use the log filter and search functionality to look at a request for that employee!

Use text filter contains "jobTitle" and URL filter contains "1800"

Select a log: in this case we can see the employee "jobTitle" is returning "null" from BambooHR

This means that the employee does not have a job title in BambooHR. Work with your customer to have it added!