> For the complete documentation index, see [llms.txt](https://village-labs.gitbook.io/coworker-product-and-developer-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://village-labs.gitbook.io/coworker-product-and-developer-docs/data-connections/monday.md).

# Monday

### Prerequisites

* A Monday account with access to view all workspaces/boards you want to sync with Coworker.

{% hint style="info" %}

## API token permissions

Each personal token can only do actions that the user can do in the UI. For example, if a user cannot access a particular private board, the API token will not be able to access that data either. This extends to any [column](https://support.monday.com/hc/en-us/articles/360011926640-Column-permissions), [item](https://support.monday.com/hc/en-us/articles/360021172320-Item-viewing-permissions-), or [account permissions](https://support.monday.com/hc/en-us/articles/360003457320-Account-permissions) that apply to a user.
{% endhint %}

### Generating the credentials

**API for admins users** 

Each admin on the account has their own API Token -- make sure to keep this safe! To generate your API Token: 

1. Log into your monday.com account.
2. Click on your avatar in the top right corner.
3. Select "Administration."
4. Click "Connections" on the left side of the admin page. 
5. Select "API" in the top menu. 
6. Click "Generate" in the top right.
7. Click on the "Copy" button to the right of the personal API Token. This is what you should be looking at:

<figure><img src="https://3561055466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcl1KIMhPQkmG41x5eGvL%2Fuploads%2FBZT0gFsdwIpMSCUDIkDb%2Fimage.png?alt=media&amp;token=f5bfe129-0fac-4b34-bb8c-a895099a0007" alt=""><figcaption></figcaption></figure>

**API for non-admin users**

If you are not an admin of your monday.com account, you can get your API Tokens via the developers' section, following these steps:&#x20;

1. Log into your monday.com account.
2. Click on your avatar in the top right corner.
3. Select "Developers."
4. Click "Developer" and then "My Access Tokens" at the top.&#x20;
5. By selecting "Show" next to the API token, you'll then be able to copy it as well.&#x20;

### Information required for the Coworker connection:

* `auth_token`: The access token created above
* `start_date`: Date of the first record to synchronize, in a ISO8601 format (eg. `2024-01-01`) . Commits before this date will not be synchronized.