Miro

How to set up a Miro integration with Ploy

Written By Matthew Berners-Lee

Last updated 3 months ago

Prerequisites

  • A Miro Enterprise plan

    • Only Miro enterprise plans allow Miro apps to access team member information, which is needed for Ploy to scan who has access

  • Company Admin role in your Miro organization

Overview

To integrate Miro and Ploy we need to create an App in the Miro Developer Hub. We’ll then configure the app to allow the integration we’ll create in ploy to access it.

Steps

Step 1: Create a Miro App

  1. Sign in to Miro

  2. Click your profile avatar in the top-right corner and select Developer Hub

  3. In the left sidebar, click the Your apps tab

  4. Click + Create new app

  5. Enter an app name (e.g. "Ploy"), select your team, check the “Expire user authorization token” checkbox, and click Create app

Step 2: Configure Permissions

Under Permissions, enable the following scope:

  • organizations:read — allows Ploy to read your organization's member list

No other permissions are required.

Step 3: Set the Redirect URI

Under Redirect URI for OAuth2.0, add the following URL:

https://api.joinploy.com/integrations/auth/miro/callback

Click Add to save it.

Step 4: Copy Your Credentials

Still on the app settings page, find the App Credentials section. You'll need two values:

  • Client ID

  • Client Secret (click to reveal)

Keep these handy for the next step, but remember they are very sensitive! Do not leave them saved on your computer

Step 5: Add the Integration in Ploy

  1. In Ploy, go to Settings → Integrations

  2. Find Miro and click Add

  3. On the first page, enter the Client ID and Client Secret you copied from Miro

  4. Click Save & Continue

Step 6: Authorize Ploy

  1. On the second page, click the Grant access button

  2. You'll be redirected to Miro to authorize Ploy to access your organization

  3. Review the permissions and click Allow

  4. You'll be redirected back to Ploy

Step 7: Test the Connection

Click Test Connection to verify everything is working. If successful, your Miro integration is ready to go.

Ploy will now scan your Miro organization members, tracking user accounts and activity.