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 the Callback URL from your Connector Profile 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

​
Create the StackOne Connector Profile

1

Create a Connector Profile

Enable the connector and create a Connector Profile in your project. See Setup Connector Profile.
2

Link an Account

Once the Connector Profile is created, continue to link an account.