> ## Documentation Index
> Fetch the complete documentation index at: https://sleekplan.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ClickUp integration

> Connect ClickUp to Sleekplan so you can link feedback posts to ClickUp tasks, create tasks from a post, and keep statuses in sync both ways.

The ClickUp integration connects your Sleekplan workspace to a ClickUp workspace so your product team can work feedback from ClickUp. From any feedback post you can link an existing ClickUp task or create a new one, and a link back to the Sleekplan post is added to the task automatically. You can also map statuses so that moving a task in ClickUp updates the post, and changing a post's status updates the task.

<Info>
  Integration settings live in the workspace Settings, which are available to workspace **owners** and **admins**. Team members with the Member role won't see the Integrations screen. See [Roles and permissions](/help/account-security/roles-permissions).
</Info>

## Before you start

* You need a ClickUp account with access to at least one ClickUp workspace.
* One ClickUp workspace connects to one Sleekplan workspace. If a ClickUp workspace is already connected to another Sleekplan workspace, you cannot connect it again until you disconnect it there first.

## Connect ClickUp

<Steps>
  <Step title="Open the Integrations settings">
    Go to [**Settings → Integrations**](https://app.sleekplan.com/settings/integrations). ClickUp is listed under **All integrations**.

    <img src="https://mintcdn.com/sleekplangmbh/7sCFHm2Bm3uXI56F/images/integrations-clickup-list.png?fit=max&auto=format&n=7sCFHm2Bm3uXI56F&q=85&s=6b6166da04249b7b7b22a366d1a55d07" alt="The Integrations settings screen with the ClickUp row highlighted under All integrations" width="1440" height="900" data-path="images/integrations-clickup-list.png" />
  </Step>

  <Step title="Start the connection">
    Find **ClickUp** in the list and click **Connect**. A ClickUp authorization window opens in a new tab.
  </Step>

  <Step title="Authorize in ClickUp">
    Sign in to ClickUp if you are prompted, then approve access for Sleekplan. On ClickUp's **Connect ClickUp** screen, select the ClickUp workspaces you want to grant access to and click **Connect Workspace**. ClickUp sends you back to Sleekplan and the connection is activated.

    <img src="https://mintcdn.com/sleekplangmbh/7sCFHm2Bm3uXI56F/images/integrations-clickup-connect-workspace.png?fit=max&auto=format&n=7sCFHm2Bm3uXI56F&q=85&s=494b74009d1e4a6b350f22a992fb6947" alt="ClickUp's Connect ClickUp authorization screen with workspaces to select and the Connect Workspace button" width="2844" height="1624" data-path="images/integrations-clickup-connect-workspace.png" />
  </Step>

  <Step title="Confirm it connected">
    Back on [**Settings → Integrations**](https://app.sleekplan.com/settings/integrations), ClickUp now appears under **Connected** with a **Connected** tag. Click **Manage** to configure it.
  </Step>
</Steps>

## Choose the ClickUp workspace

When you connect, Sleekplan links the first available ClickUp workspace. If your ClickUp account has more than one workspace, you can switch which one is connected.

<Steps>
  <Step title="Open ClickUp's settings">
    On [**Settings → Integrations**](https://app.sleekplan.com/settings/integrations), find ClickUp under **Connected** and click **Manage**.
  </Step>

  <Step title="Select a workspace">
    Use the **Select Workspace** picker to choose the ClickUp workspace you want to connect, then click **Save**.
  </Step>
</Steps>

<Note>
  Switching the connected workspace resets the status sync mapping below, because statuses belong to the lists in a specific workspace. Set your status mapping again after changing workspaces.
</Note>

## Sync statuses both ways

Status sync keeps a post and its linked task aligned. It works in both directions:

* When a linked ClickUp task changes status, the mapped Sleekplan post moves to the matching status.
* When you change a post's status in Sleekplan, the linked ClickUp task moves to a matching status.

You set this up in two parts inside the **Manage ClickUp** dialog: first pick which ClickUp lists to sync, then map the statuses those lists contain to your Sleekplan statuses.

<Steps>
  <Step title="Turn on the lists you want to sync">
    For each ClickUp list, there is a **Sync status updates from "Space" > "List"** toggle. Turn on the lists whose statuses you want to map, then click **Save**. Saving loads the available statuses from those lists so you can map them in the next step.
  </Step>

  <Step title="Map each ClickUp status to a Sleekplan status">
    Reopen **Manage**. For each ClickUp status pulled from your enabled lists, a **Sync status "..."** picker appears. Choose the Sleekplan status it should map to, or leave it on **None** to skip that status. Click **Save**.
  </Step>
</Steps>

<Note>
  A status set to **None** is not synced in either direction. Only mapped statuses trigger updates.
</Note>

## Link and create tasks from a feedback post

Once ClickUp is connected, a **ClickUp** panel appears in the right sidebar of every feedback post. This is where you link, create, and unlink tasks.

<Steps>
  <Step title="Open a feedback post">
    Go to your [**Feedback**](https://app.sleekplan.com/feedback) board and open the post you want to work on. Find the **ClickUp** panel in the post's right sidebar.
  </Step>

  <Step title="Link an existing task">
    In the **ClickUp** panel, type a task title in the search field (or enter `#` followed by a task ID) and submit. Pick the task from the results to link it. Sleekplan adds a comment to the ClickUp task with a link back to this post.
  </Step>

  <Step title="Or create a new task">
    Click **Create new task**, then fill in a **Title** and **Description**, choose the **List** it should go into, and set a **Priority** (Low, Normal, High, or Urgent). Click **Create**. The new task is created in ClickUp, linked to the post, and gets a comment linking back to the post.

    <img src="https://mintcdn.com/sleekplangmbh/7sCFHm2Bm3uXI56F/images/integrations-clickup-task-backlink.png?fit=max&auto=format&n=7sCFHm2Bm3uXI56F&q=85&s=160db05271aa79deebf31c519f333abd" alt="A ClickUp task with an automatic comment linking back to the Sleekplan post it was created from" width="2724" height="1300" data-path="images/integrations-clickup-task-backlink.png" />
  </Step>

  <Step title="Unlink when you're done">
    To disconnect a task from a post, open the **ClickUp** panel and click **Unlink task**. The post and task are no longer linked, and a comment noting the unlink is added to the task. Unlinking does not delete the ClickUp task.
  </Step>
</Steps>

## Disconnect ClickUp

To stop syncing, go to [**Settings → Integrations**](https://app.sleekplan.com/settings/integrations), click **Manage** on the ClickUp row, and click **Disconnect**. This stops status syncing and removes the connection. You can reconnect at any time by connecting again.

## Related

<CardGroup cols={2}>
  <Card title="Feedback statuses" icon="list-checks" href="/help/feedback/statuses">
    Set up the Sleekplan statuses you map ClickUp statuses to.
  </Card>

  <Card title="Import & export" icon="arrow-right-arrow-left" href="/help/integrations/export">
    Move your workspace data in and out of Sleekplan.
  </Card>
</CardGroup>
