Skip to main content
With the Miro integration, you can see boards, and on an Enterprise plan the organization, its members, teams, and user groups:
  • Sync boards on any plan
  • On Enterprise, sync organization members, teams, and user groups

Supported resources

Organization external users and team guests are not roles. Opal does not use Miro SCIM.

Requirements

  • You must be an Opal admin.
  • You must be able to create an app under your Miro avatar and install it on a team.
  • For organization members, teams, and user groups, the plan must be Enterprise and the token must belong to a Company Admin.

1. Create a Miro app and install it

In Miro, open your avatar and go to Settings → Your apps. Create an app and install it on one team. This connection is a service account: there is no user login. Follow Miro’s service account use case and install the app. Grant scopes from Permission scopes: Do not grant the write scopes. team:read does not list teams. The token lifetime is chosen once, on the create-app dialog, with Expire user authorization token. Miro locks that choice. See Authorization flow for expiring tokens. Non-expiring. Leave the checkbox unchecked. Copy the access token from the install dialog. You do not need a client ID, client secret, or refresh token. The token stays valid until you uninstall the app. See Use access token for REST API requests. Expiring. Check the box when you create the app. The install dialog then shows an access token and a refresh token. Copy both, and copy the client ID and client secret from the app settings page. A refresh token that is not used for 60 days expires. Install the app again and paste the new pair.

2. Create a Miro app in Opal

One connection is one Miro organization. Opal reads the organization from the token. You do not type an organization id. In Opal, go to Inventory > +App and select Miro. Fill in the following fields and select Create. If you fill in any of Client ID, client secret, or refresh token, fill in all three.

3. Import Miro items

Organization members sync as accounts on the app when the plan is Enterprise. After creating the app, import boards and the organization from … > Import items. On an Enterprise plan, that import also includes teams and user groups.
Last modified on November 16, 2026