Articles in this section

Miro

Integromat Updated February 26, 2021 03:52

The Miro modules allow you to watch, create, update, retrieve, and delete the boards, and widgets in your Miro account.

Getting Started with Miro

Prerequisites

A Miro account

In order to use Miro with Integromat, it is necessary to have a Miro account. If you do not have one, you can create a Miro account at miro.com/signup.

The module dialog fields that are displayed in bold (in the Integromat scenario, not in this documentation article) are mandatory!

Connecting Miro to Integromat

1. Go to Integromat and open the Miro module's Create a connection dialog.

2. Enter a name for the connection and click Continue.

3. Confirm the access by clicking Install or Reinstall. If you are establishing the connection for the first time, the Install button appears.

The connection has been established.

Miro app allows only one connection for one user. You will receive an error if you try to create a second connection with the same user. You need to delete any existing connection of the user before creating a new one.

Boards

Watch Boards

Triggers when a board is created or modified.

Connection	Establish a connection to your Miro connection.
Watch Boards	Select or map the option to watch the boards: By Created Time By Modified Time
Limit	Set the maximum number of boards Integromat should return during one execution cycle.

List Boards

Retrieves a list of all boards for the current user and the current team.

Connection	Establish a connection to your Miro connection.
Limit	Set the maximum number of boards Integromat should return during one execution cycle.

Get a Board

Returns the data of the specified board.

Connection	Establish a connection to your Miro connection.
Board ID	Select or map the Board ID whose details you want to retrieve.

Create a Board

Creates a new board.

Connection	Establish a connection to your Miro connection.
Name	Enter a name for the board.
Description	Enter the details of the board.
Team Access	Select or map the board access for the team: Private: Nobody in the team can find and access the board. View: Any team member can find and view the board. Comment: Any team member can find and comment on the board. Edit: Any team member can find and edit the board.
Access	Select or map the member access type: Private: Nobody in the team can find and access the board. View: Any team member can find and view the board. Comment: Any team member can find and comment on the board.

Update a Board

Updates an existing board.

Connection	Establish a connection to your Miro connection.
Board ID	Select or map the Board ID whose details you want to update.
Name	Enter a name for the board.
Description	Enter the details of the board.
Team Access	Select or map the board access for the team: Private: Nobody in the team can find and access the board. View: Any team member can find and view the board. Comment: Any team member can find and comment on the board. Edit: Any team member can find and edit the board.
Access	Select or map the member access type: Private: Nobody in the team can find and access the board. View: Any team member can find and view the board. Comment: Any team member can find and comment on the board.

Copy a Board

Copies an existing board.

Connection	Establish a connection to your Miro connection.
Original Board ID	Select or map the Board ID you want to copy.
Name	Enter a name for the board.
Description	Enter the details of the board.
Team Access	Select or map the board access for the team: Private: Nobody in the team can find and access the board. View: Any team member can find and view the board. Comment: Any team member can find and comment on the board. Edit: Any team member can find and edit the board.
Access	Select or map the member access type: Private: Nobody in the team can find and access the board. View: Any team member can find and view the board. Comment: Any team member can find and comment on the board.

Widgets

Watch Widgets

Triggers when a widget is created or modified.

Connection	Establish a connection to your Miro connection.
Watch Boards	Select or map the option to watch the boards: By Created Time By Modified Time
Board ID	Select or map the Board ID whose widgets you want to watch.
Widget Type	Select or map the widget type you want to watch. For example, `Sticker`, `Shape`, `text`.
Limit	Set the maximum number of widgets Integromat should return during one execution cycle.

List Widgets

Retrieves a list of up to 1000 widgets in a specified board.

Connection	Establish a connection to your Miro connection.
Board ID	Select or map the Board ID whose widgets you want to list.
Widget Type	Select or map the widget type you want to list. For example, `Sticker`, `Shape`, `text`.
Limit	Set the maximum number of widgets Integromat should return during one execution cycle.

Get a Widgets

Returns the data of a specified widget.

Connection	Establish a connection to your Miro connection.
Board ID	Select or map the Board ID whose widget details you want to retrieve.
Widget	Select or map the widget whose details you want to retrieve.

Team

Get a Team

Returns the data of a specified widget.

Connection	Establish a connection to your Miro connection.
Team ID	Enter the Team ID whose details you want to retrieve. If left blank, returns the team details of the current user.

Other

Make an API Call

Performs an arbitrary authorized API Call

Connection	Establish a connection to your Miro account.
URL	Enter a path relative to `https://api.miro.com`. For example: `/v1/{team_id}/boards` For the list of available endpoints, refer to the Miro API Documentation.
Method	Select the HTTP method you want to use: GET to retrieve information for an entry. POST to create a new entry. PUT to update/replace an existing entry. PATCH to make a partial entry update. DELETE to delete an entry.
Headers	Enter the desired request headers. You don't have to add authorization headers; we already did that for you.
Query String	Enter the request query string.
Body	Enter the body content for your API call.

Example of Use - List Boards

The following API call returns all the boards related to the specified team from your Miro account:

URL:
/v1/teams/{team_id}/boards

Method:
GET

Matches of the search can be found in the module's Output under Bundle > Body > data.
In our example, 10 boards numbers were returned:

Was this article helpful?

1 out of 1 found this helpful