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

# Miro

> Steps for integrating with Miro.

## Supported Features

<Badge color="blue">Account Deletion</Badge> <Badge color="blue">Account Creation</Badge>

## Connecting with Miro

The integration method differs between the Enterprise plan and other plans. If you are on the Enterprise plan, use the Enterprise (OAuth) integration. For all other plans, use the standard (ID/Password) integration.

### Standard Integration (Non-Enterprise)

<Info>
  With ID/Password integration, external authentication accounts such as Google or SSO cannot be used. For details, see [\[Restriction\] Integration Failure with Google Authentication or SSO External Authentication Accounts](/en/it-management/faq/7gbneu0vz5-auth-error).
</Info>

#### Prerequisites

**Obtaining the Workspace Key**

After logging in to Miro, click the icon in the upper right and click **Settings**.

<img src="https://mintcdn.com/moneyforwardi/8rNSDZnPhsTE7YvM/images/integrations/av6idlf6qh/1722385654834.png?fit=max&auto=format&n=8rNSDZnPhsTE7YvM&q=85&s=ddde86aebd734691c57ff8c1bfc1b754" alt="Miro settings menu screenshot" width="3086" height="722" data-path="images/integrations/av6idlf6qh/1722385654834.png" />

Select the organization (Company) you want to connect, then navigate to the Profile page. Part of the URL is a number — this is your workspace key. Save it for later.

```
https://miro.com/app/settings/company/{workspace-key}/user-profile
```

<img src="https://mintcdn.com/moneyforwardi/8rNSDZnPhsTE7YvM/images/integrations/av6idlf6qh/1727154936903.png?fit=max&auto=format&n=8rNSDZnPhsTE7YvM&q=85&s=43d03bf12cbaf26d15d1ecac2db892b8" alt="Obtaining the workspace key screen" width="3058" height="1400" data-path="images/integrations/av6idlf6qh/1727154936903.png" />

If you have multiple organizations, the workspace key differs per organization. Save each workspace key separately.

#### Integration Setup

In the Admina integrations screen, search for **Miro** and select `ID/Password`.

Enter your Miro login email address, password, and the workspace key you obtained, then click **Connect**.

<Info>
  Due to the following restriction, external authentication accounts such as Google or SSO cannot be used. Please prepare an administrator account that can log in with an email address and password before proceeding.

  [\[Restriction\] Integration Failure with Google Authentication or SSO External Authentication Accounts](/en/it-management/faq/7gbneu0vz5-auth-error)
</Info>

<img src="https://mintcdn.com/moneyforwardi/8rNSDZnPhsTE7YvM/images/integrations/av6idlf6qh/1722386653564.png?fit=max&auto=format&n=8rNSDZnPhsTE7YvM&q=85&s=acedfbe2a5c61d1a8b1879c3c35c4b1a" alt="ID/Password integration setup screen" width="970" height="1544" data-path="images/integrations/av6idlf6qh/1722386653564.png" />

Once the integration with Miro is successful, registered user information will appear in the account list.

If you have multiple teams, the workspace key differs per team. Follow the same steps for each team.

If the process did not complete successfully, go to the Status tab on the integrations screen, click Edit.
Try connecting again.

If the issue persists, please contact us via chat.

For an overview of the Miro integration, see the [integration page](http://admina.moneyforward.com/en/integrations/miro).

### Enterprise Plan Integration

#### How to Obtain the Client ID and Client Secret

1. Follow the instructions at the URL below to **create an OAuth App**.

   [https://help.miro.com/hc/en-us/articles/4766759572114](https://help.miro.com/hc/en-us/articles/4766759572114)

2. Add the following **redirect URI**:

   ```
   https://itmc.i.moneyforward.com/oauth/callback
   ```

<img src="https://mintcdn.com/moneyforwardi/8rNSDZnPhsTE7YvM/images/integrations/av6idlf6qh/1661152937936.png?fit=max&auto=format&n=8rNSDZnPhsTE7YvM&q=85&s=956520f2233b510938d4c1a67b4e9c12" alt="Redirect URI configuration" width="1110" height="440" data-path="images/integrations/av6idlf6qh/1661152937936.png" />

3. For Permissions, select **`organizations:read`**.

<img src="https://mintcdn.com/moneyforwardi/8rNSDZnPhsTE7YvM/images/integrations/av6idlf6qh/1664521539417.png?fit=max&auto=format&n=8rNSDZnPhsTE7YvM&q=85&s=950e568ebff8611bf1f2bd642e19070d" alt="Permissions configuration" width="1188" height="798" data-path="images/integrations/av6idlf6qh/1664521539417.png" />

4. From App Credentials, copy and save the **Client ID and Client secret**.

<img src="https://mintcdn.com/moneyforwardi/8rNSDZnPhsTE7YvM/images/integrations/av6idlf6qh/1664521444186.png?fit=max&auto=format&n=8rNSDZnPhsTE7YvM&q=85&s=84ca23638b9079dc3bf0dcfc3e03879e" alt="Obtaining Client ID and Client secret" width="1082" height="478" data-path="images/integrations/av6idlf6qh/1664521444186.png" />

#### Integration Setup

In the Admina integrations screen, search for **Miro** and select `OAuth`.

Enter the **Client ID** in the Client ID field and the **Client secret** in.
The Client Secret field obtained in the previous steps, then click **Connect**.

<Info>
  To retrieve the **last activity date** of each Miro account, enter the email address and password and click Connect.
</Info>

<img src="https://mintcdn.com/moneyforwardi/8rNSDZnPhsTE7YvM/images/integrations/av6idlf6qh/1722388097525.png?fit=max&auto=format&n=8rNSDZnPhsTE7YvM&q=85&s=8bfbd34341610faa09cabe46ef8d3fd4" alt="OAuth integration setup screen" width="490" height="774" data-path="images/integrations/av6idlf6qh/1722388097525.png" />

Once the integration with Miro is successful, registered user information will appear in the account list.

If the process did not complete successfully, go to the Status tab on the integrations screen, click Edit.
Try connecting again.

If the issue persists, please contact us via chat.

For an overview of the Miro integration, see the [integration page](http://admina.moneyforward.com/en/integrations/miro).
