Connect

Prerequisites:

Before integrating Miro with Zluri, ensure:

• You have a Miro “Company Admin” account for Enterprise plans.
• You have (or can generate) Miro API Credentials (Client ID and Client Secret).

Step 1: Get API Credentials from Miro

For Enterprise Accounts

1. Login to your Miro account with “Company Admin” role.
2. Create a Developer Team:
   • Go to Company Settings → Teams → Create a New Team.
   • Keep permission settings as default.
   • Check the Developer Team box.
   • (More details in Miro Documentation.)
3. Create Developer App:
   • Select Build Apps → Enter the app name.
   • Select the developer team created above.
   • Uncheck Expire User Authentication Token.
4. Configure OAuth Redirect:
   • Go to Settings → Your Apps.
   • Select the custom app you created under Created Apps.
   • Under Redirect URI for OAuth 2.0, add:

     https://integrations.zluri.com/connect_callback/mirocustom

For Non-Enterprise Accounts

1. Visit: Create Dev Team.
2. Follow steps 1–4 above to create the developer app and configure redirect URI.

Scopes to Select in Miro (Permissions → All Plans)

For User Info:

• boards:read
• identity:read
• team:read

For Workflow Actions:

• boards:write
• identity:write
• team:write

💡 For team:read and team:write, you must be a Team Admin of the team being connected.

Enterprise Plan Only — Additional Scopes:

• auditlogs:read → Provides activity info for accurate usage data.
• organizations:read → Provides workspace-wide user and license info.
• organizations:teams:read → Retrieves team-level details.
• organizations:teams:write → Allows workflow actions at team level.

After Scopes Are Selected:

• Navigate to Zluri → Sources → Integrations → Browse Catalog and search for Miro Enterprise (Custom).
• In Miro Settings → Your Apps → Created App → App Credentials, copy your Client ID and Client Secret.
• Authenticate in Miro when prompted.
• Once authenticated, you’ll see a connection successful pop-up.
• Data will populate in Zluri within 24–48 hours.

Step 2: Begin Integration in Zluri

• Click Connect Integration or Connect another instance.

Step 3: Review and Add Scopes

• Review Required Scopes in Zluri.
• (Optional) Add other scopes as per your needs.
• Proceed with Self-Authorization or Co-worker Authorization.

💡 Self-Authorization: Continue to Step 4 and enter the credentials yourself.
💡 Co-worker Authorization: Send the request to a co-worker with admin access via invite email or link.
They will use the Unique Connect Code to authorize and proceed to Step 4.

Step 4: Authorize the Connection

• Enter your Client ID and Client Secret from Step 1.
• Click Connect.

✅ Success!
Your Miro Custom integration with Zluri is complete.