> 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/clickup.md).

# ClickUp

[ClickUp](https://clickup.com/) is a cloud-based collaboration and project management tool suitable for businesses of all sizes and industries. Features include communication and collaboration tools, task assignments and statuses, alerts and a task toolbar.

To begin, you will need:

* A [ClickUp](https://www.clickup.com/) account
* A ClickUp workspace with Admin/Owner access.

## Account integration using OAuth

**STEP 1:** Open the [ClickUp dashboard](https://app.clickup.com/).

**STEP 2:** Click on your **profile icon** in the bottom left.

**STEP 3:** Click on **\[Settings]** under your workspace profile.

![](https://3400071099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FypCKq44Psaly6khgrY7x%2Fuploads%2FKg6KVINnYnbgdnB7dekA%2FClickUp_OAuth_03.png?alt=media\&token=7eaf9458-ebac-467d-aa6e-ed3a6cbb73ab)

**STEP 4:** In the left side-bar, Click on **\[ClickUp API]**.

<img src="https://3400071099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FypCKq44Psaly6khgrY7x%2Fuploads%2FLWDcEJbmo6bjn5WoZqvj%2FClickUp_OAuth_04.png?alt=media&amp;token=83ceaa1b-4375-4924-958c-d16a630e5930" alt="" width="222">

**STEP 5:** Click on the **\[+ Create an App]** button in the top-right.

![](https://3400071099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FypCKq44Psaly6khgrY7x%2Fuploads%2FIt4leQW4BZicH5vXharv%2FClickUp_OAuth_05.png?alt=media\&token=b40377f6-ae83-41fb-98d3-6e311f3baf83)

**STEP 6:** Enter the name of your app in the **App Name** field.

![](https://3400071099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FypCKq44Psaly6khgrY7x%2Fuploads%2FVAAQRQ4n7nFTjSKzuu6d%2FClickUp_OAuth_06.png?alt=media\&token=6c9d8f35-dc31-43c3-9efc-d4f1265f75d8)

**STEP 7:** In iMBrace, copy the **OAuth Callback URL** provided in the ClickUp OAuth2 API credentials.

![](https://3400071099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FypCKq44Psaly6khgrY7x%2Fuploads%2FuEFBp3ia5X4YZ1TH2CP1%2F4.png?alt=media)

**STEP 8:** In ClickUp, paste it in the **Redirect URL(s)** field.

**STEP 9:** Click on the **\[Create App]** button.

![](https://3400071099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FypCKq44Psaly6khgrY7x%2Fuploads%2FH4vQHjZFU7NAvtffKl5W%2FClickUp_OAuth_09.png?alt=media\&token=d26f8386-71e8-4f16-afaa-c0ab0ed16225)

**STEP 10:** Copy the displayed **client ID**.

![](https://3400071099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FypCKq44Psaly6khgrY7x%2Fuploads%2FNu7i6kjmqPA8ehJIXBJr%2FClickUp_OAuth_10.png?alt=media\&token=a3f5a6ec-7271-4a76-bb13-cdeceed424bf)

**STEP 11:** In iMBrace, enter a name for your credentials in the **Credentials Name** field in the ClickUp OAuth2 API credentials.

![](https://3400071099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FypCKq44Psaly6khgrY7x%2Fuploads%2F3NBRiArPaomcvYmFJ2iC%2F8.png?alt=media)

**STEP 12:** Paste the client ID in the **Client ID** field in the ClickUp OAuth2 API credentials.

![](https://3400071099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FypCKq44Psaly6khgrY7x%2Fuploads%2FOtUBXnbeh5WDWexEF7Rl%2F9.png?alt=media)

**STEP 13:** Copy the client secret from ClickUp.

![](https://3400071099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FypCKq44Psaly6khgrY7x%2Fuploads%2FU8JKwv2RhysZw41Us88y%2F10.png?alt=media)

**STEP 14:** In iMBrace, paste the **client secret** in the **Client Secret** field in the ClickUp OAuth2 API credentials.

![](https://3400071099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FypCKq44Psaly6khgrY7x%2Fuploads%2FL2NOEBHBGEOT23cqUS5e%2F11.png?alt=media)

**STEP 15:** Click on the **\[connect]** button in the OAuth section to connect a ClickUp account to iMBrace.

<img src="https://3400071099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FypCKq44Psaly6khgrY7x%2Fuploads%2F7es6toUTyzTqyEsup7ta%2F12.png?alt=media" alt="" width="533">

**STEP 16:** In iMBrace, click the **\[Save]** button to save your credentials.

**DONE:** The credentials can then be used for ClickUp nodes.

## **Account integration using Access Token**

**STEP 1:** Open the [ClickUp dashboard](https://app.clickup.com/).

**STEP 2:** Click on your **profile icon** in the bottom left.

**STEP 3:** Click on the **\[Apps]** under your user profile.

![](https://3400071099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FypCKq44Psaly6khgrY7x%2Fuploads%2FywV8sD4e6XBd1CICvD5V%2FClickUp_Token_03.png?alt=media\&token=deda0ea6-69fb-48ff-a93f-c9c6a86e0bef)

**STEP 4:** Click on the **\[Generate]** button under the **API Token** section.

![](https://3400071099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FypCKq44Psaly6khgrY7x%2Fuploads%2FokacL0oxc9YRiu9ngSwp%2F14.png?alt=media)

**STEP 5:** Click on the **\[Copy]** to copy the token.

![](https://3400071099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FypCKq44Psaly6khgrY7x%2Fuploads%2FilTSkcmbAwfYskUTlu5f%2F15.png?alt=media)

**STEP 6:** In iMBrace, enter a name for your credentials in the **Credentials Name** field in the ClickUp API credentials.

**STEP 7:** In iMBrace, paste the token in the **Access Token** field in the ClickUp API credentials.

![](https://3400071099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FypCKq44Psaly6khgrY7x%2Fuploads%2FlG1FW98lAUq4WLSmQ1y3%2F17.png?alt=media)

**STEP 8:** Click on the **\[Create]** button to create credentials.

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