ClickUp integration
Overview
Section titled “Overview”Connect ClickUp so Promptless can start documentation work when a task moves into a status you choose, and read ClickUp tasks while it researches. Connecting creates a webhook in your ClickUp workspace that sends Promptless task status changes. The connection alone starts no work. A ClickUp status trigger decides which statuses start documentation work.
Promptless reads ClickUp tasks with the access of the ClickUp account that authorizes the connection. Besides tasks that match a trigger, Promptless reads any task it finds referenced in a pull request, message, or request, using the task ID. Apart from creating its webhook, Promptless only reads from ClickUp.
In this guide, you connect ClickUp, check the connection, and disconnect it.
Before you start
Section titled “Before you start”- A ClickUp account in the workspace whose tasks you want Promptless to watch.
Connect ClickUp
Section titled “Connect ClickUp”You need a ClickUp account in the workspace whose task statuses you want Promptless to watch.
-
On the Promptless Integrations page, select Connect ClickUp.
-
If ClickUp asks you to log in, log in with the ClickUp account you want Promptless to use.
-
In ClickUp, authorize Promptless for the workspace.
-
After ClickUp redirects you to Promptless, confirm that ClickUp shows as connected on the Integrations page.
Promptless creates a webhook in your ClickUp workspace that sends task status changes to Promptless. ClickUp calls a workspace a team, so the ClickUp card lists your authorized workspaces as teams.
Promptless watches one workspace. When the ClickUp account belongs to more than one, Promptless watches the first workspace ClickUp returns for it. To choose the workspace, connect with a ClickUp account that belongs to that workspace only.
Check the connection
Section titled “Check the connection”- On the Integrations page, on the ClickUp card, select Check access.
Promptless lists the workspaces the connection can reach. When it can reach none, the card shows Needs reconnect. Reconnect ClickUp from its card.
Disconnect ClickUp
Section titled “Disconnect ClickUp”- On the Integrations page, on the ClickUp card, select Disconnect ClickUp.
ClickUp status changes stop starting documentation work, and your ClickUp status triggers show as inactive until you reconnect. The webhook Promptless created stays in your ClickUp workspace, and Promptless ignores its deliveries.
See also
Section titled “See also”- ClickUp status trigger, to choose which statuses start documentation work
- Connection health, if a ClickUp trigger stops starting documentation work