Miro

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

Prerequisites

  • A Miro account

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

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

61f273a34519c.gif

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.

61f273a5b2adb.png

The connection has been established.

Note

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.

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 Make should return during one execution cycle.

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 Make should return during one execution cycle.

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.

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.

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.

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.

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 Make should return during one execution cycle.

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 Make should return during one execution cycle.

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.

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.

Performs an arbitrary authorized API Call

Connection

Establish a connection to your Miro connection.

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.

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

61f273a6dbc37.png

Matches of the search can be found in the module's Output under Bundle > Body > data.

In our example, 10 boards numbers were returned:

61f273a80459e.png