# 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.

![](/files/6dyqnGThQIfY26xf58mC)

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

![](/files/IZwfGJh2kgHNqjAwe431)

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

![](/files/g97lhVuTJnheCSoSwjl8)

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

![](/files/WZBnXZXmIEGYVbvOC3tr)

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

![](/files/kcHD8GqbsxUYNv2j5loC)

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

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

![](/files/4lTBPpK82shbYvr3jC83)

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

![](/files/93aOLwx95kCiCCAXwcUa)

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

![](/files/3PxcnWT80nRdWDexHr4h)

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

![](/files/1S7dpAiVULgPZGVgxvT8)

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

![](/files/9L5ByYzmUYzDACdQ7MLz)

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

![](/files/Dj1bQ3AgvHPfNRKA6UOc)

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

![](/files/36E6tR7tHHSSyvMRkaUr)

**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.

![](/files/IS34wx83cCIDohhvO6Zw)

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

![](/files/G6u7aK2QaDoa7AAWMotE)

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

![](/files/QjtzqADUGhGMlP3CC9Px)

**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.

![](/files/LdI86m15lUekMoxmoACS)

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

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://imbrace.gitbook.io/imbrace-documentation/integrations/clickup.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.