Monday v2

Getting Started with Monday

The Monday modules allow you to manage boards, column values, tags, users, items, and updates in your Monday account.

Prerequisites

  • A Monday account

In order to use Monday with Integromat, it is necessary to have a Monday account. If you do not have one, you can create a Monday account at auth.monday.com/users/sign_up.

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

Connecting Monday to Integromat

To connect your Monday account to Integromat you need to obtain the API Key from your Monday account.

1. Log in to your Monday account.

2. Click on your account icon in the bottom-left corner.

3. Open the Admin settings.

bEikgiVDAv.gif

4. Navigate to the API section.

5. Click on the Generate link to generate API v2 Personal Token.

bSXUawSm4J.gif

6. Copy the generated API Token.

7. Go to Integromat, open the Create a connection dialog of your Monday module.

8. Enter the Personal API Key you have copied in step 5 to the API Key field and click the Continue button.

The connection is now established and you can proceed in setting up your Monday module.

Column Values

Get an Item's Column Value

Retrieves the value of a selected column within an item.

ConnectionEstablish a connection to your Monday account.
Board IDSelect the board that contains the value you want to retrieve.
Item IDSelect the item that contains the column value you want to retrieve.
Column IDSelect 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).

2019-08-02_14_35_57-Integration_Monday_v2___Integromat.png

Update Column Values of a Specific Item

Allows you to update multiple column values within an item.

ConnectionEstablish a connection to your Monday account.
Board IDSelect the board that contains the item you want to update.
Item IDSelect the item that contains the columns you want to update.
Array of column values to changeAdd and define changes to the columns' values.

Watch Item's Column Value

Triggers when a value in a column is changed.

ConnectionEstablish a connection to your Monday account.
Board IDSelect the board that contains the item you want to watch for changes.
Item IDSelect the item that contains columns whose values you want to watch for changes.
Column IDSelect the column whose value you want to watch for changes.

Boards

List Boards

Returns a list of boards.

ConnectionEstablish a connection to your Monday account.
LimitSet the maximum number of boards Integromat will return during one cycle.

Duplicate a Group

Creates a copy of a selected group.

ConnectionEstablish a connection to your Monday account.
TitleEnter the title of the new group.
Board IDSelect or map the board that contains the group you want to create a copy of.
Group IDSelect or map the group you want to duplicate.
Add to the topIf this option is enabled, the newly created group is added to the top of the board.

List Board's Groups

Returns a list of groups in a selected board.

ConnectionEstablish a connection to your Monday account.
LimitSet the maximum number of groups Integromat will return during one cycle.
Board IDSelect or map the board you want to retrieve groups from.

Tags

Create or Get a Tag

ConnectionEstablish a connection to your Monday account.
Tag NameEnter the name of the new tag.
Board IDSelect or map the board where you want to create a new tag.

Users

List Teams

Retrieves all teams in your account.

ConnectionEstablish a connection to your Monday account.
LimitSet the maximum number of teams Integromat will return during one cycle.

Watch Team's Users

Triggers when a user has joined a selected team.

ConnectionEstablish a connection to your Monday account.
LimitSet the maximum number of users Integromat will return during one cycle.
Team IDSelect or map the team you want to watch for new users.

Items

Get an Item

Retrieves the details of an item.

ConnectionEstablish a connection to your Monday account.
IDEnter the Item ID. The ID can be retrieved, for example, using the List Board's Items or List Group's Items modules.

Search Items by their Column Values

Returns the column values of the columns you search for.

ConnectionEstablish a connection to your Monday account.
LimitSet the maximum number of column values Integromat will return during one cycle.
Board IDSelect or map the board you want to search for column values.
Column IDSelect the column you want to search for values.
Column ValueEnter the column value you want to search the columns for.

2019-08-02_11_54_39-Integration_Monday_v2___Integromat.png

Create an Item

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

ConnectionEstablish a connection to your Monday account.
Item nameEnter the name of the item.
Board IDSelect or map the board you want to add the item to.
Group IDSelect the group you want to place the item to. If no group is selected, the item will be placed to the topmost group.
Array of column values to changeAdd desired column values.

Delete or Archive an Item

ConnectionEstablish a connection to your Monday account.
IDEnter or map the ID of the item you want to delete or archive.
Archive onlyEnable this option to archive the item (the item will not be deleted).

Move an Item to a Group

Moves the selected item to a selected group.

ConnectionEstablish a connection to your Monday account.
Item IDEnter (map) the ID of the item you want to move to another group.
Board IDSelect or map the board you want to move the item to.
Group IDSelect the target group that you want to move the item to.

List Board's Items

Returns a list of all items within a board.

ConnectionEstablish a connection to your Monday account.
LimitSet the maximum number of items Integromat will return during one cycle.
Board IDSelect or map the board you want to retrieve items from.

List Group's Items

Returns a list of all items within a selected group.

ConnectionEstablish a connection to your Monday account.
LimitSet the maximum number of items Integromat will return during one cycle.
Board IDSelect or map the board that contains a group with the items you want to retrieve.
Group IDSelect or map the group you want to retrieve items from.

Watch Board's Items

Triggers when a new item is created in a selected board.

ConnectionEstablish a connection to your Monday account.
LimitSet the maximum number of items Integromat will return during one cycle.
Board IDSelect or map the board you want to watch for new items.

Watch Group's Items

Triggers when a new item is created in a selected group.

ConnectionEstablish a connection to your Monday account.
LimitSet the maximum number of items Integromat will return during one cycle.
Board IDSelect or map the board that contains the group you want to watch for new items.
Group IDSelect or map the group you want to watch for new items.

Updates

Create an Update

Creates an update note for an item.

ConnectionEstablish a connection to your Monday account.
Item IDEnter (map) the item you want to add the update note to.
BodyEnter the text content of the update.
The HTML formatting is supported.

List Updates

Retrieves a list of all updates in your account.

ConnectionEstablish a connection to your Monday account.
LimitSet the maximum number of updates Integromat will return during one cycle.

Watch Item's Update

Triggers when a new update is created for the selected item.

ConnectionEstablish a connection to your Monday account.
LimitSet the maximum number of updates Integromat will return during one cycle.
Board IDSelect or map the board that contains the item you want to watch for new updates.
Item IDSelect or map the item you want to watch for new updates.

Other

Execute a GraphQL Query

Allows you to perform a custom API call.

ConnectionEstablish 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 }
}
When you copy the query from the API documentation examples, the module may throw the RuntimeError due to a Parse error:
mceclip0.png
mceclip0.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:

MethodPOST
Query
mutation MyUpdateText($newText:JSON!) {
change_column_value (
board_id: 364921717,
item_id: 364921724,
column_id: "text",
value: $newText
) { id }
}
VariablesSee the screenshot below. Please note the quotation marks around the value.
mceclip1.png

Popular use cases from our blog

automated-data-collection-crm-illustration

How to Automate Data Collection - Part 5: CRM Systems

automated-data-collection-chatbot-marketing-illustration

How to Automate Data Collection - Part 4: Chatbot Marketing

automated-data-collection-paid-ads-illustration

How to Automate Data Collection - Part 3: Paid Ads

automated-data-collection-email-illustration

How to Automate Data Collection - Part 2: Email Marketing Segmentation

personalized-customer-experience-illustration-integromat

5 Automated Solutions to Personalize Customer Experience

data-collection-automation-forms-pt-1

How to Automate Data Collection - Part 1: Online Forms

Didn’t find what you were looking for?

Expert

Find an expert

We feature a network of 450+ certified partners across the globe who are ready to help

Find an expert

Automate any workflow in your business

Sign up for a free account today. No credit card required, no time limits on free plan.