Skip to main content
Use a separate Miro app for this connection type. Once the organization permissions are enabled on an app, Miro only lets Enterprise plan Company Admins authorize it, so never add them to an app that other users connect through.

​
Create an Enterprise OAuth Application

Set up a dedicated Miro app for Enterprise organization access.

1

Create a New App

Create an app in the Miro Developer Portal, signed in as a Company Admin of your Enterprise organization.

  • Go to Miro Developer Portal and select the Your apps tab
  • Click + Create new, enter an App name (e.g., “StackOne Enterprise”) and select a team in your Enterprise organization
  • Tick Expire user authorization token and click Create app
2

Obtain Client Credentials

Copy your OAuth credentials and register the StackOne redirect URI.

  • In App Credentials, copy the Client ID and Client secret
  • In Redirect URI for OAuth2.0, add https://api.stackone.com/connect/oauth2/miro/callback and click Add
3

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, Get Unified Group, Get Unified Organization, Get Unified User, List Board Items, List Board Members, List Board Tags, List Boards, List Connectors, List Projects, List Unified Groups, List Unified Organizations, List Unified Users, 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

Enable the permissions this connection uses.

  • In Permissions, select identity:read, boards:read, boards:write, projects:read, projects:write, organizations:read and organizations:teams:read
  • The account that connects must be a Company Admin of the Enterprise organization

​
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 (Enterprise organization)
  • 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.