Skip to main content
Admin access to your Rippling account is required to create API tokens.

​
Creating an API Token

Generate an API token from the API Tokens app in Rippling to enable API access.

1

Access the API Tokens App

Sign in to your Rippling admin account.

  • Navigate to Tools > Developer in the left sidebar.
  • Click on API Tokens.
  • Alternatively, search for “API Tokens” in the search bar.
2

Create a New API Token

Click Create API Token to generate a new token.

  • Enter a Name for the token (e.g., StackOne Integration).
  • Provide a unique Identifier for the token.
  • Select the API Version (recommended to use the latest version).
3

Configure Permissions

Select the API permissions (scopes) required for your integration.

  • Enable scopes based on the data you need to access (e.g., workers.read, companies.read).
  • Tokens inherit the permissions of the user who created them.
  • Click Save to create the token.
4

Copy the API Token

Copy the generated API Token and store it securely for use later.

  • The token is only displayed once and cannot be retrieved later.
  • Treat the token like a password and keep it secure.

​
Important Notes

Keep these considerations in mind when using Rippling API tokens.

  • Tokens expire after 30 days of inactivity.
  • Tokens inherit the permissions of the user who created them.
  • Keep the API token secure and do not share it publicly.

​
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.