Miro

Overview

Connect your users to Miro for collaborative whiteboards, visual project planning, and team ideation.

Property	Value
Provider ID	miro
Category	Productivity
PKCE	Supported
Token refresh	Automatic
Redirect URI	Shown in Developer Portal

Step 1: Create a Miro OAuth App

Open Miro Apps settings

Sign in to Miro and go to miro.com/app/settings/user-profile/apps.

Create a Developer team

If you don’t already have one, create a Developer team — Miro requires app development to happen inside a sandboxed Developer team.

Create a new app

Click + Create new app, enter an app name, and assign it to your Developer team.

Configure the redirect URI

Open the new app’s settings, add the Alter callback URL from the Developer Portal to the Redirect URI for OAuth2.0 field, and select the required scopes.

Get credentials

Copy the Client ID and Client Secret.

Warning

Never share your Client Secret publicly. Store it securely and only enter it in the Alter Vault Developer Portal.

Step 2: Add to Alter Vault

Open the Developer Portal

Go to portal.alterauth.com and navigate to the application.

Add Miro provider

Go to OAuth Providers > Add Provider > Miro.

Enter credentials

• Client ID: Paste your Miro Client ID
• Client Secret: Paste your Miro Client Secret

Select scopes

Choose the scopes the application needs.

Save

Click Save. The provider is now active.

Available Scopes

Scope	Description
boards:read	View Miro boards and their content
boards:write	Create and modify Miro boards
identity:read	View user profile information
team:read	View team information and membership

Notes

• See the Miro developer documentation for more details on available API endpoints.

Policy-cataloged operations

Alter policy rules can target these attested operations and families for operation-level and parameter-aware controls.

Operation ID	Families	Method	Provider path
enterprise-invite-team-member	admin, send	POST	/v2/orgs/{org_id}/teams/{team_id}/members
delete-app-card-item	delete	DELETE	/v2/boards/{board_id}/app_cards/{item_id}
delete-board	delete	DELETE	/v2/boards/{board_id}
delete-card-item	delete	DELETE	/v2/boards/{board_id}/cards/{item_id}
delete-case	delete	DELETE	/v2/orgs/{org_id}/cases/{case_id}
delete-code-widget-item	delete	DELETE	/v2-experimental/boards/{board_id}/code_widgets/{item_id}
delete-connector	delete	DELETE	/v2/boards/{board_id}/connectors/{connector_id}
delete-doc-format-item	delete	DELETE	/v2/boards/{board_id}/docs/{item_id}
delete-document-item	delete	DELETE	/v2/boards/{board_id}/documents/{item_id}
delete-embed-item	delete	DELETE	/v2/boards/{board_id}/embeds/{item_id}
delete-frame-item	delete	DELETE	/v2/boards/{board_id}/frames/{item_id}
delete-image-item	delete	DELETE	/v2/boards/{board_id}/images/{item_id}
delete-item	delete	DELETE	/v2/boards/{board_id}/items/{item_id}
delete-item-experimental	delete	DELETE	/v2-experimental/boards/{board_id}/items/{item_id}
delete-legal-hold	delete	DELETE	/v2/orgs/{org_id}/cases/{case_id}/legal-holds/{legal_hold_id}
delete-mindmap-node-experimental	delete	DELETE	/v2-experimental/boards/{board_id}/mindmap_nodes/{item_id}
delete-shape-item	delete	DELETE	/v2/boards/{board_id}/shapes/{item_id}
delete-shape-item-flowchart	delete	DELETE	/v2-experimental/boards/{board_id}/shapes/{item_id}
delete-sticky-note-item	delete	DELETE	/v2/boards/{board_id}/sticky_notes/{item_id}
delete-tag	delete	DELETE	/v2/boards/{board_id}/tags/{tag_id}
delete-text-item	delete	DELETE	/v2/boards/{board_id}/texts/{item_id}
createGroup	admin, write	POST	/v2/boards/{board_id}/groups
enterprise-boards-create-group	admin, write	POST	/v2/orgs/{org_id}/boards/{board_id}/groups
enterprise-create-group	admin, write	POST	/v2/orgs/{org_id}/groups
enterprise-create-group-member	admin, write	POST	/v2/orgs/{org_id}/groups/{group_id}/members
enterprise-create-project	admin, write	POST	/v2/orgs/{org_id}/teams/{team_id}/projects
create-app-card-item	write	POST	/v2/boards/{board_id}/app_cards
create-card-item	write	POST	/v2/boards/{board_id}/cards
create-case	write	POST	/v2/orgs/{org_id}/cases
create-code-widget-item	write	POST	/v2-experimental/boards/{board_id}/code_widgets
create-connector	write	POST	/v2/boards/{board_id}/connectors
create-doc-format-item	write	POST	/v2/boards/{board_id}/docs
create-document-item-using-file-from-device	write	POST	/v2/boards/{board_id_PlatformFileUpload}/documents
create-embed-item	write	POST	/v2/boards/{board_id}/embeds
enterprise-board-content-item-logs-fetch	read	GET	/v2/orgs/{org_id}/content-logs/items
enterprise-board-export-job-results	read	GET	/v2/orgs/{org_id}/boards/export/jobs/{job_id}/results
enterprise-board-export-job-status	read	GET	/v2/orgs/{org_id}/boards/export/jobs/{job_id}
enterprise-board-export-job-tasks	read	GET	/v2/orgs/{org_id}/boards/export/jobs/{job_id}/tasks
enterprise-board-export-jobs	read	GET	/v2/orgs/{org_id}/boards/export/jobs
enterprise-boards-get-groups	read	GET	/v2/orgs/{org_id}/boards/{board_id}/groups