> ## Documentation Index
> Fetch the complete documentation index at: https://support.i.moneyforward.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Bonusly

> How to integrate with Bonusly. This explains the full process, from getting a Personal Access Token through to completing the integration.

## Prerequisites

### Getting your Personal Access Token

1. After logging in to [Bonusly](https://bonus.ly/), select **Admin settings** from the avatar menu at the bottom left of the screen.

   <img src="https://mintcdn.com/moneyforwardi/0m8dATJ2oGiVgLdF/images/integrations/bonusly/account-menu.png?fit=max&auto=format&n=0m8dATJ2oGiVgLdF&q=85&s=3fd1510eab3267b1d1e3b9a1d39e045e" alt="Avatar menu" width="259" height="277" data-path="images/integrations/bonusly/account-menu.png" />

2. Select **Company** > **Integrations**, then select **API & Tokens** under **Custom development**.

3. On the **Personal Access Tokens** screen, click **Create token**.

4. Enter any name for **Token name** and set **Expires after**. Under **Scopes**, check **user:administer**, then create the token.

   <img src="https://mintcdn.com/moneyforwardi/0m8dATJ2oGiVgLdF/images/integrations/bonusly/create-token.png?fit=max&auto=format&n=0m8dATJ2oGiVgLdF&q=85&s=d31d7e4475893029bceac539d2e9f925" alt="Create token screen" width="671" height="700" data-path="images/integrations/bonusly/create-token.png" />

5. Copy and save the **Token** shown. The token is shown only on this screen, so be sure to save it now.

   <img src="https://mintcdn.com/moneyforwardi/0m8dATJ2oGiVgLdF/images/integrations/bonusly/token-created.png?fit=max&auto=format&n=0m8dATJ2oGiVgLdF&q=85&s=afd2d88df87ae5151e7f4dcb4f39d769" alt="Token issued screen" width="529" height="379" data-path="images/integrations/bonusly/token-created.png" />

## Setting up the integration

1. On the integration screen, search for **Bonusly**.

2. Enter the API key from the previous step, then click **Connect**.

   <img src="https://mintcdn.com/moneyforwardi/0m8dATJ2oGiVgLdF/images/integrations/bonusly/integrate-workspace.png?fit=max&auto=format&n=0m8dATJ2oGiVgLdF&q=85&s=71e4391ed0782df3e2cac81706701e1f" alt="Integration setup screen" width="666" height="620" data-path="images/integrations/bonusly/integrate-workspace.png" />

3. Once the integration with Bonusly succeeds, registered user information appears in the account list. If it doesn't complete successfully, first try the steps in [Troubleshooting failed SaaS integrations](/en/it-management/saas-management/93nahw45is-trouble). If that doesn't resolve it, check [Information to provide](/en/it-management/saas-management/93nahw45is-trouble#info-to-provide) and contact [support](/en/contact-support).