Skip to main content

​
Miro Connectors

Connect Parable to Miro to ingest collaboration data across boards, board items (sticky notes, shapes, cards, text, frames, and more), board members, tags, groups, and connectors. Enterprise plan customers can also ingest organization members, teams, and audit logs.

Bearer Token

Non-expiring access token from your Miro Developer Portal app.

​
Authentication Overview

Miro supports two credential types. Parable currently uses non-expiring bearer tokens:
  • Non-expiring bearer token — a static token generated in the Miro Developer Portal when creating an app with the non-expiring token option. Does not expire and does not require token refresh. This is the supported auth strategy for v1.
  • OAuth 2.0 — short-lived access token (1 hour) plus refresh token (60 days). Requires a browser-based authorization flow per user. Supported in a future release.
Non-expiring token behavior is configured at app creation time in the Miro Developer Portal and cannot be changed afterwards. Create a dedicated app for Parable with the non-expiring token option selected.

​
Available Taps

TapDescriptionPlan
boardsAll boards accessible to the tokenAny
board_itemsAll items on each board (sticky notes, shapes, cards, frames, etc.)Any
board_membersMembers and roles for each boardAny
board_tagsTags defined on each boardAny
board_connectorsLines/arrows connecting items on each boardAny
board_groupsItem groups on each boardAny
audit_logsOrganization-level audit events (incremental)Enterprise
organization_membersAll members of the organizationEnterprise
organization_teamsAll teams within the organizationEnterprise
team_membersMembers of each organization teamEnterprise
Enterprise-gated taps are disabled by default and must be explicitly enabled in the connector settings. They require an Enterprise plan and an org_id in the connector ingestion config.