> ## Documentation Index
> Fetch the complete documentation index at: https://docs.withampersand.com/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/i4a56x-Fmj6u7jdE/images/provider-guides/c2b6e32-Screenshot_2024-07-30_at_22.53.45.png?fit=max&auto=format&n=i4a56x-Fmj6u7jdE&q=85&s=b3dac58560f018f2912b7c2a68a883d9" 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/Bx3tggG51e0liOp-/images/provider-guides/6ca06fa-miro1.gif?s=5ed133fa09f535f50ab1294780941907" 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/CkzFg-K1u4gYx3ZD/images/provider-guides/dd47b7a-Ampersand.png?fit=max&auto=format&n=CkzFg-K1u4gYx3ZD&q=85&s=d580aa00cc421fe14cfbab79c2e0812f" 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/Bx3tggG51e0liOp-/images/provider-guides/8105f9e-miro2.gif?s=e4e9c53808961117879fdaeb697b0c65" 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.