Skip to main content

Miro

Availability
Available CoreAvailable StandardAvailable PlusAvailable ProAvailable Enterprise FlexAvailable PyAirbyte
Connector type (beta)
Available Data replicationNot available Agent(learn more)
Support Level
Marketplace
Connector Version
0.0.69 (last updated 14 minutes ago)
Sync Success Rate
Low
Usage Rate
Low
Data workers used
0.2 per sync (Learn more)
Definition ID
f8276ae8-4ada-4ae5-819c-b1836aa78135

Airbyte connector for Miro can be used to extract data related to board content, user activities, and collaboration metrics, enabling integration with data warehouses and further analysis of team interactions and productivity.

Prerequisites​

The connector authenticates with a Miro OAuth access token. Miro's app Client ID and Client secret don't work as the API key.

  1. In Miro, open Profile settings > Your apps and create an app. Leave Expire user authorization token cleared. The connector doesn't refresh tokens, so an expiring token stops working after one hour, and Miro doesn't let you change this setting after you create the app.
  2. Under Permissions, enable the boards:read scope.
  3. Click Install app and get OAuth token, choose the team whose boards you want to sync, and click Allow.
  4. Copy the access token and paste it into the API Key field.

The connector only reads boards that the token's user has access to in the team you installed the app to.

Configuration​

InputTypeDescriptionDefault Value
api_keystringAPI Key. A Miro OAuth access token.

Streams​

Stream NamePrimary KeyPaginationSupports Full SyncSupports Incremental
boardsidDefaultPaginator✅❌
board_usersid, board_idDefaultPaginator✅❌
board_itemsDefaultPaginator✅❌
board_tagsDefaultPaginator✅❌
board_groupsNo pagination✅❌
board_connectorsidDefaultPaginator✅❌

The boards stream lists every board the token can access. The other streams are child streams that make requests for each board in the boards stream and add a board_id field to every record.

Limitations​

  • The connector doesn't paginate the board_groups stream, so it only syncs the first page of groups that Miro returns for each board.
  • Miro rate limits API requests per user and per app using a credit system, with a global limit of 100,000 credits per minute. Because the child streams make requests for every board, syncs of accounts with many boards can reach this limit. When that happens, Miro returns a 429 Too Many Requests error and the connector retries the request after waiting.

IP allow list​

If you use Airbyte Cloud and your organization restricts access to specific IPs, add the Airbyte Cloud IP addresses to your allow list.

Reference​

Config fields reference

Field
Type
Property name
string
api_key

Changelog​

Expand to review
VersionDatePull RequestSubject
0.0.692026-10-0387649Document that the API key is a Miro OAuth access token
0.0.682026-09-2987236Update dependencies
0.0.672026-09-2286693Update dependencies
0.0.662026-09-1586144Update dependencies
0.0.652026-09-0885570Update dependencies
0.0.642026-08-1884652Update dependencies
0.0.632026-08-1184022Update dependencies
0.0.622026-08-0483525Update dependencies
0.0.612026-07-2882983Update dependencies
0.0.602026-07-2182518Update dependencies
0.0.592026-07-1481900Update dependencies
0.0.582026-06-3081162Update dependencies
0.0.572026-06-2380539Update dependencies
0.0.562026-06-1679939Update dependencies
0.0.552026-06-0979425Update dependencies
0.0.542026-06-0278814Update dependencies
0.0.532026-04-2877346Update dependencies
0.0.522026-04-2176672Update dependencies
0.0.512026-03-3175802Update dependencies
0.0.502026-03-2475389Update dependencies
0.0.492026-03-1074593Update dependencies
0.0.482026-03-0374189Update dependencies
0.0.472026-02-1773222Update dependencies
0.0.462026-02-0372721Update dependencies
0.0.452026-01-2072023Update dependencies
0.0.442026-01-1471529Update dependencies
0.0.432025-12-1870774Update dependencies
0.0.422025-11-2570096Update dependencies
0.0.412025-11-1869529Update dependencies
0.0.402025-10-2969071Update dependencies
0.0.392025-10-2168439Update dependencies
0.0.382025-10-1467832Update dependencies
0.0.372025-10-0767385Update dependencies
0.0.362025-09-3066350Update dependencies
0.0.352025-09-1065805Update dependencies
0.0.342025-08-2365173Update dependencies
0.0.332025-08-0964698Update dependencies
0.0.322025-08-0264295Update dependencies
0.0.312025-07-2663928Update dependencies
0.0.302025-07-1963436Update dependencies
0.0.292025-07-1263209Update dependencies
0.0.282025-07-0562579Update dependencies
0.0.272025-06-2862371Update dependencies
0.0.262025-06-2161890Update dependencies
0.0.252025-06-1461031Update dependencies
0.0.242025-05-2460063Update dependencies
0.0.232025-05-0359492Update dependencies
0.0.222025-04-2759051Update dependencies
0.0.212025-04-1958496Update dependencies
0.0.202025-04-1257898Update dependencies
0.0.192025-04-0557082Update dependencies
0.0.182025-03-2956705Update dependencies
0.0.172025-03-2256063Update dependencies
0.0.162025-03-0855499Update dependencies
0.0.152025-03-0154804Update dependencies
0.0.142025-02-2254368Update dependencies
0.0.132025-02-1553849Update dependencies
0.0.122025-02-0853306Update dependencies
0.0.112025-02-0152779Update dependencies
0.0.102025-01-2552243Update dependencies
0.0.92025-01-1851827Update dependencies
0.0.82025-01-1151182Update dependencies
0.0.72024-12-2850658Update dependencies
0.0.62024-12-2150135Update dependencies
0.0.52024-12-1449629Update dependencies
0.0.42024-12-1248922Update dependencies
0.0.32024-11-0448262Update dependencies
0.0.22024-10-2947885Update dependencies
0.0.12024-10-18Initial release by @parthiv11 via Connector Builder
Was this page helpful?