Skip to main content

What You'll Need

CredentialWhat it is
Access TokenNon-expiring token from your Miro Developer Portal app
Organization IDNumeric org ID from Company Settings (Enterprise only)

​
Overview

Connect Parable to Miro using a non-expiring access token. Parable ingests boards, all board items (sticky notes, shapes, cards, frames, and more), board members, tags, groups, connectors, and — on Enterprise plans — organization members, teams, and audit logs.

Board data

Boards, items, members, tags, groups, and connectors

Activity & admin

Audit logs and organization/team membership (Enterprise)

​
Prerequisites

Dedicated app required. Create a Miro app specifically for Parable in the Developer Portal. The non-expiring token option must be selected at app creation time — it cannot be changed later.
  • A Miro account on any paid plan (Starter, Business, or Enterprise).
  • Enterprise-gated taps (audit_logs, organization_members, organization_teams, team_members) additionally require an Enterprise plan and your organization ID.

​
Setup Guide

1

Open the Miro Developer Portal

  1. Sign in to Miro.
  2. Go to miro.com/app/settings/user-profile/apps.
  3. Click Create new app.
2

Configure the app

  1. Enter an app name such as Parable Platform.
  2. Select your workspace team.
  3. Under Token expiration, select Non-expiring (this option cannot be changed after creation).
  4. Click Create app.
3

Set app permissions (scopes)

In your app settings, enable the following permissions:
ScopePurpose
boards:readRead all board data (required)
identity:readToken validation
team:readTeam information
auditlogs:readAudit logs — Enterprise only
organizations:readOrganization members — Enterprise only
organizations:teams:readOrganization teams — Enterprise only
Click Save after selecting permissions.
4

Copy the access token

  1. In your app settings, scroll to the App credentials section.
  2. Copy the Access token.
Copy your now!This is the only time it will be displayed. Store it in a secure password manager before closing this page.
5

Find your Organization ID (Enterprise)

Required for Enterprise-gated taps: audit_logs, organization_members, organization_teams, and team_members. Skip this step if you are not on an Enterprise plan.
  1. Sign in to Miro as a company admin.
  2. Open Settings (profile menu) > Company Settings > Security > Audit log.
  3. On the Audit log page, copy your Organization ID (a numeric value, typically 10-25 digits).
  4. Keep this value for the Parable connector form.
Without a valid Organization ID, Enterprise taps are skipped during sync. Board-level taps still run.
6

Connect in Parable

  1. In Parable, open Settings > Connectors > Add connector.
  2. Select Miro.
  3. Paste your access token into the Token field.
  4. (Enterprise) Paste your Organization ID from the previous step.
  5. Click Save & verify.
Success! If you received a 200 OK response with valid data, your credentials are configured correctly. You can now proceed to configure this connector in Parable.
Rate Limits: enforces rate limits of .Parable handles rate limiting automatically with exponential backoff, but initial syncs of large datasets may take longer due to these limits.

​
Additional Resources

Miro REST API Quickstart

Official guide for creating a developer app and obtaining an access token