Skip to main content
ClickUp Integration

Integrating ClickUp & Dock

Updated over 2 months ago

Overview

By integrating with ClickUp, you can pull in Tasks as Dock tasks and sync updates between the two systems.

How to Create Dock Tasks from ClickUp

To start, within a workspace or template, navigate to a checklist.

Click Add task and then Add task from ClickUp:

You'll be able to tell that something is connected by clicking on the task directly to view its details.


Turning On the Integration

An admin of Dock and ClickUp must configure this integration in order for it to be used. To do so, follow the steps below:

Step 1: Navigate to your admin panel by clicking Settings on the left hand nav bar.

Step 2: Under Integrations > Collaboration select ClickUp

Step 3: Click Configure to be taken through the flow

Step 4: Accept data permissions

Step 5: Login to ClickUp

Step 6: Connect Workspace

Step 7: Click Finish

How long will the initial sync take? The initial sync between Dock and ClickUp can take up to 72 hours depending on the number of tasks in your system. This is a one time bulk sync.


What gets synced between ClickUp & Dock?

The following data gets synced between the two systems:

ClickUp

Sync Direction

Dock

Task Name

⬅️ ➡️

Task Name

Task Description

⬅️ ➡️

Task Description

Task Due Date

⬅️ ➡️

Task Due date

Task Status

➡️

Task Status

Task Assignee

⬅️ ➡️

Task Assignee

Task Comments

⬅️ ➡️

Task Comments

What doesn't sync?

Anything that you don't see in the above table will not get synced.

On the Dock side, this means things like start date, custom statuses, and/or internal statuses will not get pushed back to ClickUp. On the ClickUp side, any custom fields or additional fields not shown above will not sync to Dock.

Additionally, please note: commenting only supports plain text.


Comments & ClickUp

Please note: Due to ClickUp's API that Dock used to build the integration, there are some nuances to comments that are worth mentioning.

Blocking Comments

If you don't want to sync comments between the two platforms, simply turn off comment syncing from the integration page.

Comments from ClickUp ➡️ Dock

Comments made in an task in ClickUp will flow over to the associated Dock task and will display the name of the person who made that comment. Please note though, Dock only supports plain text comments. You cannot attach files.

Comments from Dock ➡️ ClickUp

Comments made by an internal team member:

Comments that are posted in Dock by an internal team member (someone with both a Dock account and a ClickUp account) will post to the associated ClickUp task, but they will come from the system integrator. To help clarify who the team member was that actually posted the comment, you'll see a note in brackets:

In this ClickUp comment above:

  • Prateek Banga: is the system integrator who originally setup the connection between Dock <> ClickUp.

  • Alex Kracov: is the internal member of the team who actually left the comment in Dock.

Alex has also turned on "email profile visibility" to allow third-party apps (Dock) to view his email address. See below for instructions on how to turn this.

Comments made by a client:

When the user leaving the comment does not have a ClickUp account (i.e. your client), then here's what the message will look like:

This message came from a user "[email protected]" as denoted by the appended message to this comment.

In this example, Prateek Banga is the system integrator and that's why his name appears as the person leaving the comment and also why it says "posted on behalf of (Prateek Banga)."

Unfortunately, the quirks of this system are determined by ClickUp and our technical integration provider. There's nothing we can do about the "post on behalf of" situation. While not aesthetically pleasing, we're optimistic this integration still helps surface valuable information in each place.

How long does it take to sync?

Comments

In real time

Task Updates (besides comments)

Up to 10 minutes

New Projects + Tasks

Up to 1 hour

Did this answer your question?