> ## Documentation Index
> Fetch the complete documentation index at: https://ampersand-24eb5c1a-rajatspawar-eng-4200-readd-blob-storage.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-rajatspawar-eng-4200-readd-blob-storage/prR0nYmGsccBeYqL/images/provider-guides/c2b6e32-Screenshot_2024-07-30_at_22.53.45.png?fit=max&auto=format&n=prR0nYmGsccBeYqL&q=85&s=234407ef26e76b24730a373754f059b5" 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-rajatspawar-eng-4200-readd-blob-storage/HnK51FQ_CWEGqNhj/images/provider-guides/6ca06fa-miro1.gif?s=c0bc6692157044bcb017cd0963f3a041" 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-rajatspawar-eng-4200-readd-blob-storage/prR0nYmGsccBeYqL/images/provider-guides/dd47b7a-Ampersand.png?fit=max&auto=format&n=prR0nYmGsccBeYqL&q=85&s=80a976be90706a0ba17d50338983bbd9" 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-rajatspawar-eng-4200-readd-blob-storage/HnK51FQ_CWEGqNhj/images/provider-guides/8105f9e-miro2.gif?s=b75298f2ce9f9b505165abc7a0bd021c" 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.