Monday

Prerequisites

• A Monday account with access to view all workspaces/boards you want to sync with Village Labs.

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, item, or account permissions that apply to a user.

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:

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:

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.

5. By selecting "Show" next to the API token, you'll then be able to copy it as well.

Information required for the Village 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.