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.
Link the Account
1
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.
2
Use Actions
Connect an AI platform to the linked account’s actions. See AI Platforms.Other ways to call actions are listed in Protocols & SDKs.