Skip to main content
Select Actions to adjust the guide
Some actions may require additional configuration in the provider to be accessible. Choose the actions you need and the guide will be updated.
Action
Scope(s)
Loading actions…
Dynamic Guide URL
Scopes Selected
Separator
You need access to create apps in your Miro team. Some enterprise teams may require admin approval.


​
Create OAuth Application
Set up a new OAuth application in the Miro Developer Portal.
1
Access Developer Portal
Navigate to the Miro Developer Portal.
2
Create New App
Create a new OAuth application for your integration.
  • Click Create new app button
  • Enter an App name (e.g., “StackOne Integration”)
  • Select your team from the dropdown
  • Tick Expire user authorization token
  • Click Create app to proceed
3
Configure OAuth Settings
Get Credentials & Set up OAuth redirect URI for authentication flow
  • After creating your app, scroll down to the App Credentials section to find your Client ID and Client Secret (you’ll need these later)
  • Scroll down to the Redirect URI for OAuth2.0 section, add a new redirect URI, “https://api.stackone.com/connect/oauth2/miro/callback”
  • Click Add to save the redirect URI
4
Configure Permissions
Enables actions: Attach Tag To Item, Create App Card Item, Create Board, Create Card Item, Create Connector, Create Doc Format Item, Create Document Item, Create Document Item From File, Create Embed Item, Create Frame, Create Group, Create Image Item, Create Image Item From File, Create Project, Create Shape Item, Create Sticky Note Item, Create Tag, Create Text Item, Delete App Card Item, Delete Board, Delete Board Item, Delete Card Item, Delete Connector, Delete Doc Format Item, Delete Document Item, Delete Embed Item, Delete Frame, Delete Group, Delete Image Item, Delete Project, Delete Shape Item, Delete Sticky Note Item, Delete Tag, Delete Text Item, Detach Tag From Item, Get A Group By Its ID, Get All Groups On A Board, Get App Card Item, Get Board, Get Board Item, Get Board Member, Get Card Item, Get Connector, Get Current User, Get Doc Format Item, Get Document Item, Get Embed Item, Get Frame, Get Image Item, Get Items By Tag, Get Items Of A Group By ID, Get Items Within Frame, Get Project, Get Shape Item, Get Sticky Note Item, Get Tag, Get Tags From Item, Get Text Item, List Board Items, List Board Members, List Board Tags, List Boards, List Connectors, List Projects, Remove Board Member, Share Board, Ungroup Items, Update A Group With New Items, Update App Card Item, Update Board, Update Board Item, Update Board Member, Update Card Item, Update Connector, Update Document Item, Update Document Item From File, Update Embed Item, Update Frame, Update Image Item, Update Image Item From File, Update Project, Update Shape Item, Update Sticky Note Item, Update Tag, Update Text Item
Set up the permissions (scopes) your application will use.
  • Scroll down to the Permissions
  • Select the required scopes for your integration
  • Minimum required: identity:read (for authentication testing)
  • Common scopes: boards:read, boards:write
  • For projects: projects:read, projects:write (Enterprise plan required)
  • Click Save to apply the permissions
5
Obtain Client Credentials
Copy your OAuth credentials for use in StackOne configuration.
  • Navigate to the App Credentials tab
  • Locate Client ID and copy it
  • Locate Client secret, then copy it


​
Creating the StackOne Connector Profile

To create the Connector Profile in StackOne for Miro:

1
Navigate to Connector Profiles
Login to StackOne and navigate to Connector Profiles
2
Create New Connector Profile
  • Click + Connector Profile
  • Search for and select Miro
  • Select Type as OAuth 2.0
  • Fill out the fields using details retrieved from your provider:
    • Client ID
    • Client Secret
  • (Optional) Select Actions to be enabled for this Connector Profile
  • Click Create profile

Congratulations! The new Connector Profile will now show up in your project ready to be used. You can now continue to Link Accounts for Miro.