> For the complete documentation index, see [llms.txt](https://docs.getmesa.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.getmesa.com/connect/monday.md).

# monday.com

Have a workspace admin install MESA's app in monday.com, then connect your account to build workflows that update boards and items.

<figure><img src="https://docs.getmesa.com/assets/monday-connect.png" alt="Screenshot of a monday.com step in the MESA workflow builder, not yet connected. Spotlight the Install on Monday.com link and the Sign in with Monday.com button."><figcaption></figcaption></figure>

## Connection

When you're setting up your first workflow with monday.com, you will need to create a [Connection](https://docs.getmesa.com/going-further/credentials/) in order to connect MESA with monday.com.

A monday.com workspace admin installs MESA's app once for the whole workspace. After that, everyone in the workspace can connect.

1. If you are the admin and MESA's app is not installed yet, click Install on Monday.com in your monday.com step.
2. In monday.com, approve the app.
3. Back in your monday.com step, click Sign in with Monday.com.
4. In the monday.com window that opens, approve MESA.

After that, choose the same connection in any monday.com step. To connect another account, open the connection menu and click Add another connection.

## Configure

### Triggers

monday.com triggers check a board for changes on a schedule. Choose the board to watch, and how often to check under Repeats.

<figure><img src="https://docs.getmesa.com/assets/monday-trigger.png" alt="Screenshot of the monday.com Item Created trigger in the MESA workflow builder, with a board selected. Spotlight the Repeats setting and the Board dropdown."><figcaption></figcaption></figure>

* **Items:** Created, Name Updated, Column Value Updated, Moved To Group, Archived and Deleted.
* **Subitems:** Created, Name Updated, Column Value Updated, Archived and Deleted.
* **Columns:** Created.

### Retrieve fields from your board

In the Create Item action, choose a board and click Retrieve Fields. MESA adds one field for each column on the board, such as status labels, dates and numbers, so you can fill every column in one step.

<figure><img src="https://docs.getmesa.com/assets/monday-action.png" alt="Screenshot of the monday.com Create Item action in the MESA workflow builder, with a board selected. Spotlight the Retrieve Fields button and the board's columns."><figcaption></figcaption></figure>

Click Retrieve Fields again after you add or rename columns in monday.com.

To change one column on an existing item, use the Update Item action. Choose the column, and the value field offers choices that match it, such as the labels of a status column.

## Technical Notes

* monday.com triggers check your board on the schedule you choose under Repeats, so a change shows up in MESA at the next check. Each check picks up every change since the one before.
* Updates and replies on an item can't start a workflow. monday.com triggers read the board's activity log, which covers items, subitems and columns but not updates and replies.