> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hightouch.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Monday

> Keep your team's projects and tickets up-to-date with updated items for your Monday boards

## Supported syncing

| Sync Type | Description | Supported Sync Modes | API documentation |
| - | - | - | - |
| **Items** | Sync data from any source to a Monday board as items | Update, Insert | [Items](https://developer.monday.com/api-reference/docs/items_page) |

For more information about sync modes, refer to the [sync modes](https://docs.hightouch.com/syncs/types-and-modes.md#sync-modes) docs.

## Connect to Monday

Go to the [**Destinations** overview page](https://app.hightouch.com/destinations?from=docs) and click the **Add destination** button. Select **Monday** and click **Continue**. Authenticate Hightouch to Monday by entering your API token from your Monday account.

If you don't have an API token, follow the [instructions on **Monday** to access API tokens](https://developer.monday.com/api-reference/docs/authentication#accessing-api-tokens) depending on your role. Ensure your API token has write access to the board you are syncing to.

## Sync configuration

Once you've set up your Monday destination and have a [model](https://docs.hightouch.com/getting-started/concepts.md#models) to pull data from, you can set up your sync configuration to begin syncing data. Go to the [**Syncs** overview page](https://app.hightouch.com/syncs?from=docs) and click the **Add sync** button to begin. Then, select the relevant model and the Monday destination you want to sync to.

Select which board you'd like to sync to. Each sync sends data to one board.

### Sync mode

Hightouch supports **Update** and **Insert** mode by using Monday's GraphQL API with version 2023-10.
**Update** mode uses the [`change_multiple_column_values`](https://developer.monday.com/api-reference/docs/columns#change-multiple-column-values) mutation.
**Insert** mode uses the [`create_item`](https://developer.monday.com/api-reference/docs/items#create-an-item) mutation.

### Field mapping

Hightouch supports the following column types:

* Checkbox
* Country
* Date
* Dependency
* Email
* Hour
* Link
* Location
* Name
* Numbers
* People
* Phone
* Rating
* Status
* Tags
* Text
* Timeline
* Week
* World Clock

You may use Hightouch's object inline mapping to construct Monday's object values from your source. Below is an example sync configuration:

![](https://mintcdn.com/hightouch-3c037897/L_vQfA0JQEpeGUUo/images/destinations/destination-monday-sample-sync-config.png?fit=max\&auto=format\&n=L_vQfA0JQEpeGUUo\&q=85\&s=ad9760fda4a76b4438f686beabdf943d)

> [!TIP]
>
> Monday uses **YYYY-MM-DD** format for dates. For the most success in your sync, ensure that you use that format for your dates. You can also use Hightouch's template option to format your data.

### Record matching

In **Update mode**, Hightouch requires a unique identifier in your model with item IDs from Monday. Rows without item IDs will fail to sync.

In **Insert mode**, the source must contain a column that maps to the item name. Monday rejects any rows without an item name.

## Tips and troubleshooting

To see the exact API requests and responses from each sync run, use the [live debugger](https://docs.hightouch.com/syncs/debugger.md). To get notified by Slack, PagerDuty, SMS, or email when a sync fails, set up [sync alerts](https://docs.hightouch.com/syncs/alerting.md). If you run into an issue this page doesn't cover, [contact support](#pylon-chat).