OAuth providers
Miro
Set up Miro OAuth for collaborative whiteboarding and visual planning
Overview
Section titled “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
Section titled “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.
Step 2: Add to Alter Vault
Section titled “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
Section titled “Available Scopes”| Scope | Description |
|---|---|
boards:read | Read board content and metadata |
boards:write | Create and modify boards |
identity:read | Read user identity and profile |
team:read | Read team information |
- See the Miro developer documentation for more details on available API endpoints.