Skip to main content

Monday v2

With the Monday modules in Make, you can:

  • watch, retrieve, and update the column values

  • create, update, retrieve, duplicate, and list boards and board items

  • create or retrieve tags

  • watch, list, and retrieve teams and team users

  • watch, create, update, list, archive, and delete items and subitems

  • watch, create, and list item updates

  • watch, list, add and remove subscribers

  • add, list, and download files

  • watch events, list team members, and execute a GraphQL query

To get started with the Monday app, create an account at auth.monday.com/users/sign_up.

Connecting Monday to Make

To connect Monday app, you need to obtain the API Key from your Monday account and insert it into your Make scenario.

  1. Log in to your Monday account.

  2. Click your account icon > Administration.

    Monday_2.png
  3. Navigate to the API section and copy the Personal API Token to a safe place.

    Monday_1.png
  4. Log in to your Make account, insert a Monday module in your scenario, and click the Add button next to the Connection field.

  5. Optional: In the Connection name field, enter a name for the connection.

  6. In the API Key field, enter the details copied in step 3 and click Save.

    Monday_3.png

You have successfully established the connection. You can now edit your scenario and add more Monday modules. If your connection needs reauthorization, follow the connection renewal steps here.

Column Values

You can retrieve, watch, and update column values with the following modules.

Retrieves the value of a selected column within an item.

Connection

Establish a connection to your Monday account.

Board ID

Select the board that contains the value you want to retrieve.

Item ID

Select the item that contains the column value you want to retrieve.

Column ID

Select the column that contains the value you want to retrieve.

Map labels

If this function is enabled, the label name will be displayed in the module's output (instead of the index number).

61d6a9c903bea.png

Allows you to update multiple column values within an item.

Connection

Establish a connection to your Monday account.

Board ID

Select the board that contains the item you want to update.

Item ID

Select the item that contains the columns you want to update.

Column Values to Change

Select a column value to change.

Add and define changes to the columns' values.

Column ID

Select or map the column's identifier. For example, status.

Value

Enter the value of the column identifier selected.

Triggers when a value in a column is changed.

Connection

Establish a connection to your Monday account.

Board ID

Select the board that contains the item you want to watch for changes.

Item ID

Select the item containing columns with values you want to watch for changes.

Column ID

Select the column whose value you want to watch for changes.

Triggers when a column's value is changed within items in the board or the group. This module works only for the columns that contain the field, changed_at.

Connection

Establish a connection to your Monday account.

Board ID

Select (from the first 500) or map the board's identifier.

Column ID

Select (from the first 500) or map the board's identifier.

Group ID

Select (from the first 500) or map the group's identifier.

Limit

Set the maximum number of column values Make during one execution cycle. The default value is 100.

Triggers when the board's column values have changed.

Note

Make automatically creates a webhook in Monday once you add an instant trigger to your scenario.

Webhook Name

Enter a name for the webhook.

Connection

Establish a connection to your Monday account.

Board ID

Select or map the Board whose column values you want to watch.

You can create, update, duplicate, retrieve, and list boards and groups with the following modules.

Adds a new column to a specific board.

Connection

Establish a connection to your Monday account.

Title

Enter the name of the new column.

Type

Select or map the type of new column.

Board ID

Select (from the first 500) or map the board's identifier.

Create a new board.

Connection

Establish a connection to your Monday account.

Name

Enter a name for the board.

Kind

Select the kind of board.

Workspace ID

Enter the Workspace ID in which you want to create the board.

Folder ID

Enter the Folder ID in which you want to

Template ID

Enter the Template ID for the Board ID.

Returns a list of boards.

Connection

Establish a connection to your Monday account.

Include Columns

Select whether to include column information in the response.

Limit

Set the maximum number of boards Make will return during one cycle. The default value is 25.

Creates a new group in a specific board.

Connection

Establish a connection to your Monday account.

Name

Enter the group name.

Board ID

Select (from first 500) or map the board's identifier.

Duplicate Board

Duplicates a board.

Connection

Establish a connection to your Monday account.

Title

Enter the name board name.

Add to the Top

Select whether the new group should be added to the top.

Creates a copy of a selected group.

Connection

Establish a connection to your Monday account.

Title

Enter the title of the new group.

Board ID

Select or map the board that contains the group you want to create a copy of.

Group ID

Select or map the group you want to duplicate.

Add to the top

If this option is enabled, the newly created group is added to the top of the board.

Returns a board.

Connection

Establish a connection to your Monday account.

Board ID

Select or map the Board ID whose details you want to retrieve.

Get a Group

Returns a group.

Connection

Establish a connection to your Monday account.

Board ID

Select or map the Board ID whose group details you want to retrieve.

Group ID

Select or map the Group ID whose details you want to retrieve.

List Boards

Retrieves a list of boards.

Connection

Establish a connection to your Monday account.

Include Columns

Select whether to include column information in the response.

Limit

Set the number of boards Make will return during one execution cycle.

Returns a list of groups in a selected board.

Connection

Establish a connection to your Monday account.

Limit

Set the maximum number of groups Make will return during one cycle.

Board ID

Select or map the board you want to retrieve groups from.

Tags

You can create or retrieve tags with the following modules.

The tags mutation allows you to create new tags or receive their data if they already exist.

Connection

Establish a connection to your Monday account.

Tag Name

Enter the name of the new tag.

Board ID

Select or map the board where you want to create a new tag.

Items

You can watch, create, update, search, retrieve, and list items and board items with the following modules.

Creates subitem of an item.

Connection

Establish a connection to your Monday account.

Board ID

Select or map the Board ID whose items subitem you want to create.

Item ID

Select or map the Item ID whose

Subitem Name

Enter the subitem name.

Array of Column Values to Change

Enter the array of column values to change.

Create Labels if Missing

Select whether you want to create missing labels.

Note

You must have enough permission to change the board structure to create the label.

Retrieves the details of an item.

Connection

Establish a connection to your Monday account.

ID

Enter the Item ID. For example, the ID can be retrieved using the List Board's Items or List Group's Items modules.

Duplicates an item.

Connection

Establish a connection to your Monday account.

Board ID

Select or map the Board ID whose items you want to duplicate.

Item ID

Select or map the Item ID you want to duplicate.

With Updates

Select whether you want to duplicate the items with updates.

Searches items in the board by their column and returns data about them.

Connection

Establish a connection to your Monday account.

Limit

Set the maximum number of column values Make will return during one cycle.

Board ID

Select or map the board you want to search for column values.

Column ID

Select the column you want to search for values.

Column Value

Enter the column value you want to search the columns for.

61d6a9ca3f9fc.png

Creates an item with specified column values and returns its ID.

Connection

Establish a connection to your Monday account.

Item name

Enter the name of the item.

Board ID

Select or map the board to which you want to add the item.

Group ID

Select the group in which you want to place the item. If no group is selected, the item will be placed in the topmost group.

Array of column values to change

Add desired column values.

Connection

Establish a connection to your Monday account.

ID

Enter or map the ID of the item you want to delete or archive.

Archive only

Enable this option to archive the item (the item will not be deleted).

Moves an item between groups on the same board.

Connection

Establish a connection to your Monday account.

Board ID

Select or map the board on which you want to move the item.

Item ID

Select or map the Item ID you want to move to another group.

Group ID

Select or map the Group ID to which you want to move the item.

Retrieves a list of board items.

Connection

Establish a connection to your Monday account.

Limit

Set the maximum number of items Make will return during one cycle.

Board ID

Select or map the board you want to retrieve items.

Retrieves a list of group items.

Connection

Establish a connection to your Monday account.

Limit

Set the maximum number of items Make will return during one cycle.

Board ID

Select or map the board that contains a group with the items you want to retrieve.

Group ID

Select or map the group you want to retrieve items from.

Triggers when a new item is created or updated in the given board.

Connection

Establish a connection to your Monday account.

Limit

Set the maximum number of items Make will return during one cycle.

Board ID

Select or map the board you want to watch for new items.

Triggers when an item's name on a board has changed.

Note

Make automatically creates a webhook in Monday once you add an instant trigger to your scenario.

Webhook

Enter a name for the webhook.

Connection

Establish a connection to your Monday account.

Board ID

Select or map the Board ID whose items name you want to watch.

Triggers when a new item is created or updated in the given group.

Connection

Establish a connection to your Monday account.

Limit

Set the maximum number of items Make will return during one cycle.

Board ID

Select or map the board that contains the group you want to watch for new items.

Group ID

Select or map the group you want to watch for new items.

Triggers when an item with the given value is created or updated in the given board.

Connection

Establish a connection to your Monday account.

Limit

Set the maximum number of board items Make will return during one execution cycle.

Board ID

Select (from the first 500) or map the Board ID whose items you want to watch.

Column ID to Search the Value

Select (from the first 500) or map the Column ID to search the given value.

Column Value

Enter the string value. Use labels, for example, Done, instead of numeric indices, for example, 1 or IDs.

Output Column Values

Add the Column IDs you want to watch.

To limit data usage and increase performance, choose only the columns you need the data for. If no columns are selected, the module will return all the columns.

Watch

Choose the values you want to watch. For example, new items.

Show Parent ID

Select whether you want to view the Parent ID in the output.

Show Subitems ID

Select whether you want to view the Subitems ID in the output.

Updates

You can create, list, and watch item updates with the following modules.

Creates a new update.

Connection

Establish a connection to your Monday account.

Item ID

Enter the Item ID to which you want to add the update note.

Body

Enter the text content of the update in HTML format.

Retrieves a list of all updates.

Connection

Establish a connection to your Monday account.

Limit

Set the maximum number of updates Make will return during one cycle. The default value is 25.

Retrieves a list of item's updates.

Connection

Establish a connection to your Monday account.

Limit

Set the maximum number of item updates Make will return during one cycle. The default value is 250.

Item ID

Enter the Item ID whose updates you want to list.

Retrieves a list of replies to item's updates.

Connection

Establish a connection to your Monday account.

Limit

Set the maximum number of replies Make will return during one cycle. The default value is 250.

Item ID

Enter the Item ID whose replies you want to list.

Triggers when a new item's update is created.

Connection

Establish a connection to your Monday account.

Limit

Set the maximum number of updates Make will return during one cycle.

Board ID

Select or map the board that contains the item you want to watch for new updates.

Item ID

Select or map the item you want to watch for new updates.

Triggers when a new board's update is created.

Note

Make automatically creates a webhook in Monday once you add an instant trigger to your scenario.

Webhook Name

Enter a name for the webhook.

Connection

Establish a connection to your Monday account.

Board ID

Select or map the Board ID whose updates you want to watch.

Update Type

Select or map the update type you want to watch.

Subscribers

You can list, watch, add and remove board subscribers with the following modules.

Retrieves a list of item's (pulse's) subscribers.

Connection

Establish a connection to your Monday account.

Limit

Set the maximum number of item's subscribers Make will return during one execution cycle. The default value is 250.

Item ID

Enter the Item ID whose subscribers you want to list.

Retrieves a list of subscribers of a board by the Board ID.

Connection

Establish a connection to your Monday account.

Board ID

Select or map the Board ID whose subscribers you want to list.

Limit

Set the maximum number of subscribers Make will return during one execution cycle. The default value is 10.

Triggers when a new user is subscribed to a given board.

Connection

Establish a connection to your Monday account.

Limit

Set the maximum number of subscribers Make will return during one execution cycle. The default value is 100.

Board ID

Select (from the first 500) or map the Board ID whose subscribers you want to watch.

Adds subscribers to a board by their IDs and the board ID.

Connection

Establish a connection to your Monday account.

Board ID

Select or map the Board ID to which you want to add the subscribers.

User ID

Add the User ID to add as subscribers to the board.

Kind

Select or map the role of the subscriber. For example, owner.

Removes subscribers from a board by their IDs and the board ID.

Connection

Establish a connection to your Monday account.

Board ID

Select or map the Board ID from which you want to remove the subscribers.

User IDs

Add the User ID whom you want to remove from the board.

Files

You can list, add, and download files, update files, and add file column value to files with the following modules.

Returns a list of files based on collection of assets.

Connection

Establish a connection to your Monday account.

Asset IDs

Add Asset IDs whose files you want to list.

Adds a file to an existing update.

Connection

Establish a connection to your Monday account.

ID

Enter the ID of the update to which you want to add the file.

File

Add the file name and the file data which you want to add to the update.

Adds a file to a file column value.

Connection

Establish a connection to your Monday account.

Board ID

Select or map the Board ID to whose file column value you want to add the file.

Item ID

Select (from the first 500) or map the Item ID to whoc column values you want to add a file.

Column ID

Select or map the Column ID to which you want to add a file.

File

Add the file name including the extension, for example, .txt, and map the file data.

Downloads a file by the asset ID.

Connection

Establish a connection to your Monday account.

Asset ID

Enter the Asset ID you want to download.

Other

You can execute GraphQL query, watch events, and list team members with the following modules.

Allows you to perform a custom API call.

Connection

Establish a connection to your Monday account.

Method

Select the method of the API call you want to use. Monday supports both methods:

  • GET

  • POST

Query

Enter the desired GraphQL query. See Monday API documentation for examples and available queries.

Example: mutation { change_column_value ( board_id: 364921717, item_id: 364921724, column_id: "text", value: "\"ABCD\"" ) { id } }

Caution

When you copy the query from the API documentation examples, the module may throw the RuntimeError due to a Parse error:

mceclip0-22.png
mceclip0-23.png

WORKAROUND: Copy and paste the query to Notepad or a similar text editor that removes formatting and then copy and paste it to the Query field.

Variables

GraphQL has a first-class way to factor dynamic values out of the query, and pass them as a separate dictionary. These values are called variables. Please find more information about using variables in the Monday API documentation and in the GraphQL documentation.

Example:

Method

POST

Query

mutation MyUpdateText($newText:JSON!) { change_column_value ( board_id: 364921717, item_id: 364921724, column_id: "text", value: $newText ) { id } }

Variables

See the screenshot below. Please note the quotation marks around the value.

61d6a9cb73cc0.png

Triggers when a new event occurs in Monday.

Note

Make automatically creates a webhook in Monday once you add an instant trigger to your scenario.

Webhook Name

Enter a name for the webhook.

Connection

Establish a connection to your Monday account.

Retrieves a list of members by team ID.

Connection

Establish a connection to your Monday account.

Team ID

Select or map the Team ID whose members you want to list.

Limit

Set the maximum number of team members Make will return during one execution cycle. The default value is 25.