- 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.