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

# monday.com

monday.com provides two methods to integrate with iMBrace: OAuth tokens and personal API tokens. OAuth tokens provide more fine-grained control over the permissions that are granted to external apps like iMBrace. The following instructions show how to integrate monday.com with iMBrace using either method.

## Account integration using API token

You will need:

* A monday.com account to integrate with iMBrace
* A monday.com user with access to the above account (admin access is **not** required)

{% hint style="info" %}
For more information, you may refer to the official [monday Developers documentation](https://developer.monday.com/api-reference/docs/authentication).
{% endhint %}

**STEP 1:** Open the drop-down menu in the top-right corner, then go to **Account > \[Developers]**.

<figure><img src="https://3400071099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FypCKq44Psaly6khgrY7x%2Fuploads%2FYMF3zjJ6NZxWI5lOgyLK%2FmondayCom_Token_01.png?alt=media&amp;token=4167e91a-37d7-41a9-92ae-16d29f89c0d3" alt="" width="347"><figcaption></figcaption></figure>

**STEP 2:** In the left side-bar, go to **\[My access tokens]**.

<figure><img src="https://3400071099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FypCKq44Psaly6khgrY7x%2Fuploads%2FJygTmuz8F2yejSeCqLzW%2FmondayCom_Token_02.png?alt=media&amp;token=54013310-deba-415f-a11f-322e25da6768" alt=""><figcaption></figcaption></figure>

**STEP 3:** You will be able to access your API token here. Copy the token by clicking **\[Show]**, then clicking **\[Copy]**.

<figure><img src="https://3400071099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FypCKq44Psaly6khgrY7x%2Fuploads%2FalUIlH8gSdjiwJ2MEElj%2FmondayCom_Token_03.png?alt=media&amp;token=99d2f131-1571-4937-9867-db8f23ddaaf5" alt="" width="491"><figcaption></figcaption></figure>

**STEP 4:** In iMBrace, create a new credential of type **Monday.Com API**, paste the copied token into the **Token V2** field, then click **\[Create]**.

<figure><img src="https://3400071099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FypCKq44Psaly6khgrY7x%2Fuploads%2FJwdSyhUhzK4zVGQBjEHV%2FmondayCom_Token_04.png?alt=media&amp;token=a34a307a-3ab7-43f5-a1c2-6e1c90546c1f" alt="" width="538"><figcaption></figcaption></figure>

**DONE:** The credential can then be used for **Monday.com** nodes.

##

## Account integration using OAuth

You will need:

* A monday.com account to integrate with iMBrace
* A monday.com user with access to the above account (admin access is **not** required)

{% hint style="info" %}
For more information, you may refer to the official [monday Developers documentation](https://developer.monday.com/apps/docs/oauth).
{% endhint %}

**STEP 1:** Open the drop-down menu in the top-right corner, then go to **Account > \[Developers]**.

<figure><img src="https://3400071099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FypCKq44Psaly6khgrY7x%2Fuploads%2FYMF3zjJ6NZxWI5lOgyLK%2FmondayCom_Token_01.png?alt=media&amp;token=4167e91a-37d7-41a9-92ae-16d29f89c0d3" alt="" width="347"><figcaption></figcaption></figure>

**STEP 2:** In the left side-bar, go to **\[My apps]**. Then click **\[Build app]** or **\[Create app]**.

<figure><img src="https://3400071099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FypCKq44Psaly6khgrY7x%2Fuploads%2FQpWP04eMX8zVvQA0bHHl%2FmondayCom_OAuth_02.png?alt=media&amp;token=0200b44b-d367-43e3-93ac-99eaea668f42" alt="" width="563"><figcaption></figcaption></figure>

**STEP 3:** Fill in the relevant information for your new app. Finish creating the app by clicking **\[Save App]** at the bottom.

<figure><img src="https://3400071099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FypCKq44Psaly6khgrY7x%2Fuploads%2FDLDHohOSQaGfKkyGcmxi%2FmondayCom_OAuth_03.png?alt=media&amp;token=a6ee3abe-24df-485f-9fb1-558ef8cbe5f3" alt="" width="563"><figcaption></figcaption></figure>

**STEP 4:** Under App Credentials, identify the **client ID** and **client secret**. You can view the secret by clicking **\[Show]**, and you can copy the ID and secret by clicking **\[Copy]**.

<figure><img src="https://3400071099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FypCKq44Psaly6khgrY7x%2Fuploads%2FwtJ62GsbygTucDHChN4c%2FmondayCom_OAuth_04.png?alt=media&amp;token=0f08a193-8a3c-48af-b4af-58c9f2ddea4c" alt="" width="563"><figcaption></figcaption></figure>

**STEP 5:** In iMBrace, create a new credential of type **Monday.Com OAuth2 API** and paste the copied client ID and client secret into their respective fields. Also identify and copy the **OAuth Redirect URL**. You can copy the redirect URL by clicking **\[Copy URL]**.

<figure><img src="https://3400071099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FypCKq44Psaly6khgrY7x%2Fuploads%2FuznyDwBMDLRL1kIQdMkc%2FmondayCom_OAuth_05.png?alt=media&amp;token=26012347-49db-4e39-95d3-0d48e2f47eb1" alt="" width="533"><figcaption></figcaption></figure>

**STEP 6:** In the monday Developer Center, go to **\[OAuth]** in the left side-bar.

<figure><img src="https://3400071099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FypCKq44Psaly6khgrY7x%2Fuploads%2FumBxAXYZJZQSQveTZYeC%2FmondayCom_OAuth_06.png?alt=media&amp;token=ee367506-00fe-439d-87d7-9a3cd816d1ad" alt="" width="295"><figcaption></figcaption></figure>

**STEP 7:** Under the **Scopes** tab, select the `boards:read` and `boards:write` scopes.

<figure><img src="https://3400071099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FypCKq44Psaly6khgrY7x%2Fuploads%2FNzZwa7CoRYmHVcxa1MXj%2FmondayCom_OAuth_07.png?alt=media&amp;token=89093b64-effb-4fb1-a3ec-c07292d903ec" alt="" width="563"><figcaption></figcaption></figure>

**STEP 8:** Under the **Redirect URLs** tab, paste the copied redirect URL from step 5 into the **Redirect URLs** field. Then click **\[Save Feature]** at the bottom.

<figure><img src="https://3400071099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FypCKq44Psaly6khgrY7x%2Fuploads%2F40WILgJUTkZjy9JxmsbA%2FmondayCom_OAuth_08.png?alt=media&amp;token=e857c480-4a51-4ea1-b422-226fddf25c16" alt="" width="563"><figcaption></figcaption></figure>

**STEP 9:** In iMBrace, finish creating the credential by clicking **\[Connect]**.

<figure><img src="https://3400071099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FypCKq44Psaly6khgrY7x%2Fuploads%2FuznyDwBMDLRL1kIQdMkc%2FmondayCom_OAuth_05.png?alt=media&amp;token=26012347-49db-4e39-95d3-0d48e2f47eb1" alt="" width="533"><figcaption></figcaption></figure>

**DONE:** The credential can then be used for **Monday.com** nodes.