# Miro

> Source: https://truto.one/docs/integration-guides/miro/

## Install Miro integration

The Miro integration can be found [here](https://app.truto.one/integrations/available/5e5a5f42-3ad0-4ee6-8074-431cbe996b93). Please install it in your environments before proceeding with the steps below.

## Connecting a Miro account

1. Click on `Connect Account`
   !['Click connect account'](https://docs-assets.truto.one/truto-connect-account.png)
2. Type in a value for the Tenant ID. This can be an ID of your choosing. And then click on `Get connection link`
   !['Get connection link'](https://docs-assets.truto.one/truto-connect-account-modal.png)
3. A new link will be generated. Clicking on the link will open a new tab with the list of integrations. You can share this link with your customers too and they will be able to connect their Miro account.
   !['Share connection link'](https://docs-assets.truto.one/truto-connect-account-link.png)
4. Select Miro
   !['Select Miro'](https://docs-assets.truto.one/select-miro.png)

### Finding your Client ID and Client Secret

#### Prerequisites for Miro Integration

- `Enterprise Plan` is required for connecting this integration.
- You need to be an `Administrator` for connecting this integration.

You'll now be prompted to add the Client ID and Client Secret.

#### Create your Client ID and Client Secret

1. To find the Client ID and Client Secret, Sign in to your Miro [Developer](https://developers.miro.com/) Platform.
2. Click on the `Your apps` button as shown below.
3. Under `Your apps`, click on `Create a new app`.
   !['Click on Create APP'](https://docs-assets.truto.one/create-app-miro.png)
4. Enter `Name` for the App and click on `Create app`.
   !['Enter Name and Create APP'](https://docs-assets.truto.one/new-app-miro.png)
5. Enter `Redirect URI for OAuth2.0` and click on `Add` as shown below.

- Redirect URI

```
https://api.truto.one/connect/miro/callback
```

!['Enter redirect uri'](https://docs-assets.truto.one/redirect-uri-miro.png)

6. Under permissions, Select `organizations:read`. Click on `Connect`.
   !['Add permissions'](https://docs-assets.truto.one/permissions-miro.png)
   ::: warning
   `organizations:read` permission will only be visible to Enterprise Users.
   :::
7. Now copy `Client ID` and `Client Secret` from `APP Credentials` and Enter your `Client ID` and `Client Secret`. Click on `Connect`.
   !['Miro Client ID and Client Secret'](https://docs-assets.truto.one/credential-miro.png)
8. You'll now be asked to log in to your Miro account and allow access to Truto. Go through the steps.
   !['Sentry Token and Organization Slug'](https://docs-assets.truto.one/details-miro.png)

!['Miro API Token and Tailnet'](https://docs-assets.truto.one/flow-miro.png)

5. _Voila!_ You should now see a connection successful message. You can now close this tab.

6. Go to your Truto account and you should see the integration under Integrated Accounts. Click on the Account ID to change or edit the integration to suit your needs.

!['Miro Integrated Account'](https://docs-assets.truto.one/account-miro.png)

## Uninstalling the Miro integration

To uninstall the Miro integration from your Truto account, select the Miro [integration](https://app.truto.one/integrations/installed?search=miro) from the Integrations tab.

Click on the `Settings` tab in Miro Integration page

And then click on Uninstall. Uninstalling the integration will also remove all the Miro integrated accounts from your Truto account.

!['Uninstall Miro'](https://docs-assets.truto.one/uninstall-miro.png)