Skip to content
Last updated

Miro integration

Miro is a collaborative online whiteboard platform that enables teams to brainstorm, plan, and visualize ideas in real time. The Miro integration with Frontegg allows your application to access and manage Miro boards and items on behalf of your users.


Prerequisites

  • A Miro account with access to the developer settings
  • Permissions to create apps in your Miro team

Connect Miro

Step 1: Open the developer apps page

Sign in to Miro and navigate to Profile settingsYour apps. You can access this page directly at miro.com/app/settings/user-profile/apps.

Click Create new app.

Miro Your apps page with Create new app button highlighted

Step 2: Name your app

In the Create new app dialog, enter a name for your app and select a developer team.

Create new app dialog in Miro

Step 3: Fill in the app details

Enter Frontegg Integration as the app name, select your developer team from the dropdown, and click Create app.

Create new app dialog filled with app name and team selected

Step 4: Copy your credentials

After the app is created, you are taken to the app settings page. In the App Credentials section, copy the Client ID and Client secret. You will need these when configuring the integration in the Frontegg portal.

Keep your credentials secure

Never share your Client secret or commit it to version control.

Miro app credentials section showing Client ID and blurred Client secret

Step 5: Navigate to the OAuth redirect URI settings

Scroll down to the Redirect URI for OAuth2.0 section.

Miro redirect URI section, empty

Step 6: Add redirect URIs

Enter the following redirect URIs one at a time and click Add after each:

  • https://YOUR_MCP_GATEWAY_URL/integration-callback

Miro redirect URI field with Frontegg callback URL entered

Miro redirect URI section with the Frontegg callback URL saved

Step 7: Select permission scopes

Scroll down to the Permissions section and select the following scopes:

ScopeDescription
boards:readRead access to boards
boards:writeWrite access to boards
identity:readRead user identity information

Minimum required scopes

For basic functionality, you need boards:read and identity:read. Add boards:write to allow creating and modifying boards.

Scopes are saved automatically when you check them.

Miro permissions section with boards:read, boards:write, and identity:read selected

Configure the Frontegg portal

Once you have obtained your Client ID and Client secret from the steps above, enter them in the integration configuration page of the Frontegg portal:

  1. Open the Frontegg portal and navigate to [ENVIRONMENT] → Integrations → Miro.
  2. Enter the Client ID and Client secret in the corresponding fields.
  3. Select the required scopes.
  4. Click Save.

Additional resources