How can we help?

Miro Integration

Noga Tubi
Noga Tubi
  • Updated
Setup the Miro integration and get all the insights in Torii's dashboard

Overview

Torii integrates with your Miro account and syncs the following attributes:

  1. List of users and their roles
  2. Licenses
  3. Usage - Available for organization-level integrations

Furthermore, you can automate Miro onboarding and off-boarding using Torii workflows.

Interaction levels

Torii integrates with your Miro account on two levels:

1. Team level - The default account type
At the Team level, Torii collects data about a single team within your organization.
If you want Torii to collect data about multiple teams within your company, you must connect them one at a time.

2. Organization level 
At the Organization level, Torii collects data about the entire organization, including all teams.

Organization-level account type enables Torii to retrieve usage data and Miro's most accurate license data, including Full Member, Free Member, and Guest license types.

Connect Miro integration to Torii

Connect Team level account type

  1. Log in to Torii
  2. From Integrations, go to Miro >> Connect
  3. Choose permissions and the Team level scope (for Torii's actions, Read and take action permission is required).
  4. Click Connect
  5. Repeat for every team you wish to connect

Connect Organization level account type

For organization-level integration, a single connection is enough. Torii can pull all data about the entire organization using a single connection, including all teams.

Organization-level access requires the following permissions:

  • organizations:read

  • organizations:teams:read

  • organizations:teams:write

To enable fetching usage data, the user connecting the integration must be a "Company Admin" within Miro.

  1. Go to the Integrations page and select the Miro tile
  2. From Integrations, go to Miro >> Connect
  3. Choose permissions and the Organization level scope.
    Note that with an organization level, you can use Torii's action "Delete Miro user from the organization." To achieve it you will need:
    • Miro's SSO/SAML & SCIM enabled 
    • Read and Take action permission 
  4. Optional, enter the "SCIM Provisioning Token" if you want to be able to perform the "Delete Miro user from the organization" actionmceclip4.png
  5. Click Connect
    mceclip1.png
  6. Install and authorize - You will be asked to select a team to connect
    We recommend selecting the largest team presented, which in fact, is the
    the organization itself (an organization is also a type of team).
  7. Click Install & authorize.mceclip2.png

Actions

You can always be updated with application information and actions from our Integrations Page >> Integration Capabilities button (1) >> Integration Capabilities table.
mceclip0.png

Note the following:

Team level - If a removed user owns any boards or projects, they also will be removed.
After deleting the "Team admin," you will be able to restore the deleted items from the team's trash.mceclip0.png

    • Organization level - the boards are automatically assigned to the team's admin and are not removed from Miro.

Action Configuration

  • Team-level connections - We will automatically select the team selected upon connection.
  • Organization-level connections - You will be able to select any one of the teams in your organization.

Was this article helpful?

0 out of 0 found this helpful

Have more questions? Submit a request