MCP
A2ACreating 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.