Setting up Miro as a Source

👥

Access Required

Guru Access: You need to be an Admin, Source Creator, or relevant custom role to set up Sources

Miro Access: For Free, Starter, or Business Miro plans authenticating user must have access to the Miro team and the boards you want to sync. For Miro Enterprise users, you must be a Company Admin in Miro and have Content Admin access.

Setting up Miro as a Source (Free, Starter, or Business plans)

If your team uses Miro's Free, Starter, or Business plans, follow these steps to connect Miro as a Source in Guru.

1. In Guru, go to Manage.
2. Select Sources, then click Add Source.
3. Choose Miro from the list of integrations.
4. Update the display name for the Source (optional) and click Next.
5. Click Connect to authenticate your Miro account.
6. Follow the prompts to sign in to your Miro account and accept the OAuth2 permissions.
7. Select the boards you want to sync from the list of available boards within your Miro team.
8. Click Finish.
9. Assign which Guru Groups should have access to this content.

After completing the setup, Guru will begin syncing your selected Miro boards. Permissions for this content are managed within Guru through the Groups you assign.

✍

Note

The Miro OAuth connection is established at the team level. If your organization uses multiple Miro teams, you'll need to set up a separate integration for each team.

Objects synced from Miro Free, Starter, Business Plan

User-selected Boards within the Miro Team that the authenticating user has access to

Setting up Miro Enterprise as a Source

If your team uses Miro's Enterprise plan, use the Miro Enterprise connector to automatically sync all accessible boards and maintain native Miro permissions.

1. In Guru, go to Manage.
2. Select Sources, then click Add Source.
3. Choose Miro Enterprise from the list of integrations.
4. Update the display name for the Source (optional) and click Next.
5. Click Authenticate to connect your Miro account.
6. Follow the prompts to sign in to your Miro account and accept the OAuth2 permissions.
7. Click Finish.

All boards within your Miro team that the authenticating user has access to will be synced automatically. Unlike the standard Miro connector, you don't need to select individual boards - permissions are managed natively in Miro and respected by Guru.

Objects synced from Miro Enterprise

All Boards within the Miro Team that the authenticating user has access to

✍

Note

What's NOT synced:

• Comments: Miro's API doesn't currently provide access to comments on boards, so these won't appear in Guru.
• Empty boards: Boards that contain no items won't be synced.

Frequently asked questions about Miro

What's the difference between the Miro Connector and Miro Enterprise Connector?

The standard Miro Connector is for teams on Free, Starter, or Business plans and allows you to select specific boards to sync. Permissions are managed in Guru. The Miro Enterprise Connector is for Enterprise plan customers, automatically syncs all accessible boards, and uses native Miro permissions.

Why don't I see all my Miro boards?

Only boards that contain items will be synced. Empty boards are automatically excluded. Also, you'll only see boards that the authenticating user has access to within the Miro team.

Why aren't comments from Miro showing up in Guru?

Miro's API doesn't currently provide access to board comments, so these can't be synced to Guru. Only board-level information and item content (like text within shapes) is available.

My organization has multiple Miro teams. How do I sync boards from all of them?

The OAuth connection works at the team level, so you'll need to set up a separate Miro Source integration in Guru for each Miro team you want to sync.