Overview
Torii integrates with Bonusly and syncs the following:
| User Fields | License Types |
|---|---|
| Bonusly | |
| Status | |
| Role | |
| Last Used Date |
- Torii supports syncing multiple Bonusly accounts.
- You can constantly stay updated with application information from our Integrations Page
>> Integration Capabilities button >> Integration Capabilities table.
Requirements
Accounts & Permissions
To connect this integration, we require the following:
- A Bonusly Personal Access Token (PAT) generated by an Administrator account with Global or Tech permissions.
- When creating the token, you must select the scopes Torii needs (Bonusly no longer uses a simple Read-Only checkbox).
How to Generate the Required Token
- Log in to your Bonusly account as a Global or Tech admin.
- Go to Company → Integrations → API & Tokens.
(You can also open API & Tokens directly.) - Click Create token.
- Fill in:
- Name — a label you will recognize later (for example, “Torii integration”).
- Expiration — up to 365 days (Bonusly Personal Access Tokens expire; they do not live forever).
- Scopes — select the permissions Torii needs (see recommended scopes below).
- Click Create. Bonusly shows the token once — copy it immediately and store it securely. You will not be able to view it again.
Recommended scopes
Pick scopes in the create-token dialog. Bonusly only shows scopes your admin role is allowed to grant.
-
Sync only (read users and account data):
company:read,user:read -
Sync + Torii actions (recommended):
company:read,user:read,user:write,user:administer(required for SCIM activate/deactivate and related user actions),recognition:read,recognition:write(create / list / delete bonuses)
Note: A token with only read scopes can sync data into Torii but cannot run write actions. If a required scope is missing, Bonusly returns a forbidden error.
For more detail on Bonusly Personal Access Tokens and scopes, see Bonusly API access for admins and Bonusly authentication.
How to Connect the Integration
- Go to the Integrations Page in Torii.
- Select the Bonusly tile.
- Click Connect.
- Enter the API Access Token:
- Click Connect to finalize the integration. Once the integration is connected and synced, a green checkbox will appear next to the integration.
Actions
Torii supports performing automated actions on Bonusly users.
One of the supported actions is: Delete all Bonusly user bonuses.
Important: This action deletes only the bonuses that the selected user has received. Bonuses that the user has given to others will not be deleted.
Write actions require a token with the write/administer scopes listed above (not a read-only token).
Q&A
Q: Can I connect multiple Bonusly accounts to Torii?
A: Yes, Torii supports syncing multiple Bonusly accounts.
Q: What happens if I lose my API Access Token?
A: If the token is lost, you’ll need to generate a new one by following the steps in the How to Generate the Required Token section (Bonusly only shows the token once at creation time).
Q: Why do I need to pick scopes?
A: Bonusly Personal Access Tokens use fine-grained scopes instead of the old Read-Only checkbox. Select the recommended scopes above so Torii can sync (and optionally run actions).
Q: Do Bonusly tokens expire?
A: Yes. Personal Access Tokens expire after the period you choose (up to one year). Create a new token with the same scopes before expiration and reconnect the integration in Torii.
For any additional assistance, please contact Torii Support.