Humaans

3 min

This guide walks you through connecting your Humaans instance to Bindbee.

Before you begin

You need a Humaans account with permission to create API access tokens. The set of scopes that can be assigned to an API token is bounded by the effective permissions of the user creating the token.

Generating your Humaans API access token

Step 1: Log in to Humaans and click the three dots beside your profile icon in the top-left corner.

Step 2: Click API access tokens.

Step 3: If you already have a saved token you want to reuse, use that. Otherwise click Generate new token.

Step 4: Give the token a descriptive name, such as Bindbee, and select the following scopes:

View public data

View public and private data

Modify public and private data

View compensations

Modify compensations

Step 5: Click Create access token.

Step 6: Copy the token and save it somewhere secure on your machine. Humaans displays the token once, so if you navigate away without copying it, you will need to generate a new one.

Step 7: Paste the token into the Bindbee prompt and submit.

Note: The read scopes are what Bindbee needs to sync employee, employment, and compensation records. The modify scopes are only required if you are writing data back into Humaans. If your use case is read-only, you can safely leave the two modify scopes unselected, but a token created without them will need to be regenerated if you add write-back later.

Troubleshooting

Symptom	Likely cause
Authentication fails	The token was truncated on copy, or it has since been revoked in Humaans
Employees sync but compensation is empty	The token was created without View compensations
You cannot select the certain scopes	Your own Humaans permissions do not have that access. Ask an admin to create the token instead