> ## Documentation Index
> Fetch the complete documentation index at: https://ampersand-24eb5c1a-mintlify-9a8a4289.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Miro

## What's Supported

### Supported Actions

This connector supports:

* [Proxy Actions](/proxy-actions), using the base URL `https://api.miro.com`.

## Before You Get Started

To connect Miro with Ampersand, you will need a [Miro Account](https://miro.com/index/).

Once your account is created, you'll need to configure an app in Miro and obtain the following credentials from your app:

* Client ID
* Client Secret

You will use these credentials to connect your application to Ampersand.

### Create a Miro Account

Here's how you can sign up for a Miro account:

1. Go to the [Miro Sign Up page](https://miro.com/signup/).
2. Sign up using your preferred method.

### Creating a Miro App

Follow the steps below to create a Miro app and add the Ampersand redirect URL:

1. Log in to your [Miro](https://miro.com/login) account.

2. In [Miro Dashboard](https://miro.com/app/dashboard/), click on your profile icon in the top-right corner and select **Settings** from the dropdown menu.

3. Go to the **Your apps** tab.

4. Click **Create new app** to create a new app under your account.

5. In the **Create new app** dialog, provide the following details:
   1. **App Name**: Enter a descriptive name for your application.
   2. Select your development team from the menu.

6. Click **Create app** to proceed.

7. In the **App Credentials** section, the **Client ID** and **Client Secret** will be generated automatically.

**Note**: Make sure to note the **Client ID** and **Client Secret** as you will need these to connect your app to Ampersand.

<img src="https://mintcdn.com/ampersand-24eb5c1a-mintlify-9a8a4289/5b2rSHIoomV4o7tO/images/provider-guides/c2b6e32-Screenshot_2024-07-30_at_22.53.45.png?fit=max&auto=format&n=5b2rSHIoomV4o7tO&q=85&s=d86fc2cba2a9f26a2b0b169868958e91" alt="Miro App Credentials" width="1492" height="632" data-path="images/provider-guides/c2b6e32-Screenshot_2024-07-30_at_22.53.45.png" />

8. In the **Redirect URI** section, enter the Ampersand redirect URL: `https://api.withampersand.com/callbacks/v1/oauth`
9. Under **Permissions**, select the appropriate scopes for your app.

<img src="https://mintcdn.com/ampersand-24eb5c1a-mintlify-9a8a4289/9M6YLimXZ9Hjf03q/images/provider-guides/6ca06fa-miro1.gif?s=87eef9c8be2d786a2b20df78433843e1" alt="Miro Created App" width="1680" height="818" data-path="images/provider-guides/6ca06fa-miro1.gif" />

### Add Your Miro App Info to Ampersand

1. Log in to your [Ampersand Dashboard](https://dashboard.withampersand.com).

2. Select the project where you want to create a Miro integration.

   <img src="https://mintcdn.com/ampersand-24eb5c1a-mintlify-9a8a4289/5b2rSHIoomV4o7tO/images/provider-guides/dd47b7a-Ampersand.png?fit=max&auto=format&n=5b2rSHIoomV4o7tO&q=85&s=11f352e09100fd9587b6511ff02cf98d" alt="Ampersand Project" width="2244" height="442" data-path="images/provider-guides/dd47b7a-Ampersand.png" />

3. Select **Provider apps**.

4. Select *Miro* from the **Provider** list.

5. Enter the previously obtained **Client ID** in the **Client ID** field and **Client Secret** in the **Client Secret** field.

   <img src="https://mintcdn.com/ampersand-24eb5c1a-mintlify-9a8a4289/9M6YLimXZ9Hjf03q/images/provider-guides/8105f9e-miro2.gif?s=8b0534ec6599581c7732bc64eccd89a1" alt="Adding Miro Credentials" width="802" height="634" data-path="images/provider-guides/8105f9e-miro2.gif" />

<br />

6. Click **Save changes** to finalize the integration.