Miro

Connect Miro to Ploy to sync your Miro Enterprise organization's members, see who holds a paid Full license, and track how recently each person has been active in Miro. Once connected, Ploy can also assign Full licenses when access is granted through Ploy.

Before you begin: you'll need admin access to your Miro Enterprise organization (to create an app and, optionally, a SCIM token) and integration write permissions in Ploy.

What Ploy syncs

• Organization members as identities, including their email, role, license type, active or deactivated status, and last activity date

• Miro app access for each member, with their organization role as the entitlement

• Full-license holders, tracked as a "Full license" resource so you can see exactly who holds a paid seat and request or review that access in Ploy

• Usage activity, based on each member's last activity in Miro

Ploy reads your organization's member list through Miro's Enterprise API, so this integration requires a Miro Enterprise plan. Standard or Business plans cannot sync organization members.

Create a Miro app

1. In Miro, open the developer area for your account and create a new app (from your profile menu, look for Developer hub, then Your apps, then Create new app).

2. In your app's settings, add this redirect URL: https://api.joinploy.com/integrations/auth/miro/callback

3. Under the app's permissions, enable the organizations:read scope so Ploy can read your organization's members.

4. Copy the Client ID and Client Secret from your app's credentials.

It doesn't matter whether your app is set to expire user authorization tokens — Ploy supports both expiring tokens (using the refresh token) and non-expiring tokens.

Generate a SCIM token (optional)

Only needed if you want Ploy to assign Full licenses when access is granted through Ploy. Generate the token in Miro under Company Settings → Security → SCIM. This is available on the Enterprise plan only. You can skip this step and add the token later.

Connect Miro to Ploy

1. In Ploy, go to Integrations and select Miro.

2. Enter your OAuth Client ID (required).

3. Enter your OAuth Client Secret (required).

4. Optionally, enter your SCIM API Token — required only for assigning Full licenses on access grant.

5. Continue to the next step and click Grant access. You'll be redirected to Miro — click the button to allow Ploy access to your Miro organization.

6. Ploy exchanges the authorization code and automatically detects your Miro organization. Use Test to confirm the connection works.

What Ploy can change

If you've provided a SCIM token, Ploy can assign a Full license to a user when access to the "Full license" resource is granted through Ploy (for example via an access request). Miro's API only supports upgrading a user to a Full license — downgrading or removing a license isn't possible through the API, so downgrades must be done in Miro directly.

Without a SCIM token the integration is read-only: Ploy syncs members, license holders, and usage, but cannot make changes in Miro.

Troubleshooting

• "Miro authentication failed. Please try again." or "Failed to authenticate with Miro" — double-check the Client ID and Client Secret, then run through Grant access again to re-authorize.

• The Grant access step completes but the connection fails — Ploy could not find an organization on the authorized token. Make sure the account you authorize with belongs to a Miro Enterprise organization.

• "SCIM token rejected by Miro. Regenerate it under Company Settings → Security → SCIM and try again." — the SCIM token you entered is invalid or has been revoked. Generate a fresh one and save it in the wizard.

• "Failed to verify SCIM token with Miro. Please try again." — Miro returned an unexpected error while checking the SCIM token. Retry, and regenerate the token if it keeps failing.

• "Connected to Miro but received an unexpected response. Please contact ploy support for assistance" — the connection reached Miro but the response wasn't what Ploy expected; our team is notified automatically, but do reach out to support so we can help.