Skip to main content
Owner or Admin access to your Humaans account is required to generate API access tokens.

​
Generate an API Access Token

To connect Humaans with StackOne, you need an API access token from your Humaans account.

1

Sign in to Humaans

Sign in to your Humaans account with Owner or Admin credentials.

2

Navigate to API Access Tokens

Click the three dot menu (⋮) next to your name/workspace at the top-left and select API access tokens from the dropdown.

3

Create a new access token

Click Generate new token to create a new API access token.

  • Enter a descriptive Name for the token (e.g., StackOne Integration).
  • Select the required Scopes based on the data you need to access. For full access, enable all scopes.
  • Click Create access token to generate the token.
4

Copy the access token

Copy the generated access token and store it securely for use later. The token is only displayed once and cannot be retrieved again.

​
Understanding Scopes

Humaans API tokens use scopes to control access. Select scopes based on the data your integration needs.

1

Available scopes

Choose from the following scopes when creating your token.

  • public:read — View data that is public to the entire company.
  • private:read — View all data except compensations and documents.
  • private:write — Modify all data except compensations and documents.
  • compensations:read — View compensation data.
  • compensations:write — Modify compensation data.
  • documents:read — View personal documents and identity documents.
  • documents:write — Modify personal documents and identity documents.
  • webhooks:manage — View and modify webhooks.

​
Linking the Account from the Hub

1

Navigate to the Hub

Use one of the three Linking Account Methods to access the Hub.
2

Fill out the fields

Fill out the following fields using details from your provider:
  • API Token
3

Connect

  • Click Connect
  • If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider’s authorization flow.
  • Once authorization is successful, you will see a confirmation popup

If the account linking is successful, you will see the newly linked account in your Accounts page.