Miro
Collaborate on Miro whiteboards — list, get, and create boards, shapes, and sticky notes.
Miro
Miro is a collaborative online whiteboard platform. The AACFlow block uses the Miro REST API v2 to automate board management and add visual elements programmatically.
Official API documentation: https://developers.miro.com/docs/rest-api-reference-guide
Setup
- Go to https://miro.com/app/settings/user-profile/apps and create a Developer App.
- Under OAuth & Permissions, add the scopes
boards:readandboards:write. - Use the OAuth 2.0 Authorization Code flow or generate a developer token to obtain a Bearer token.
- In AACFlow, add a Miro block and paste the token into the Access Token field (stored as a secret).
Operations
| Operation | Description |
|---|---|
miro_boards | Fetch a paginated list of boards accessible to the authenticated user. |
miro_board | Get details of a specific board by its ID. |
miro_create_board | Create a new board with a given name and optional description. |
miro_shape | Add a shape (rectangle, circle, triangle, etc.) to a board at specified coordinates. |
miro_sticky | Add a sticky note with text and color to a board at specified coordinates. |
Example workflow
After a project kick-off meeting is logged in a CRM, a workflow creates a new Miro board named after the project and populates it with sticky notes for each action item from the meeting transcript.
Links
- Official API docs: https://developers.miro.com/docs/rest-api-reference-guide
- Miro Developer Apps: https://miro.com/app/settings/user-profile/apps
- Block source: apps/aacflow/blocks/blocks/miro.ts