Skip to main content
The ClickUp integration updates leads in Octanist when a task changes status in ClickUp. Octanist marks the lead as qualified, won, or lost and sets its value. Those updates are then sent to your connected ad platforms.

What you need

  • An Octanist Professional plan or higher.
  • The admin or owner role in your Octanist organization.
  • A ClickUp API token and your Workspace ID.
  • Tasks with an email or phone custom field. Octanist uses these to find the lead.
  • Optional: a currency custom field on the task, used as the lead value.

Table of Contents

  1. Prepare ClickUp
  2. Enter your credentials
  3. Map your statuses
  4. Set fallback values
  5. Finalize setup
  6. What happens next
  7. Common problems

1. Prepare ClickUp

  1. In ClickUp, open your settings and go to Apps. Copy your API Token, or generate one.
  2. Find your Workspace ID. ClickUp’s API documentation calls this the Team ID.
  3. Make sure the tasks for your leads have an email or phone custom field filled in.
Keep your API token safe. Anyone with the token can access your ClickUp workspace.

2. Enter your credentials

  1. In Octanist, go to Integrations and click Add integration.
  2. Find ClickUp and click Set up.
  3. Enter your API Token and Workspace ID.
  4. Click Next Step.

3. Map your statuses

Enter the ClickUp status names that should update the lead:
  • Qualified Status Name: a task in this status marks the lead as qualified, for example qualified.
  • Winner Status Name: a task in this status marks the lead as won, for example closed.
  • Lost Status Name: a task in this status marks the lead as lost, for example lost.
All three are required. Click Next Step.
The spelling must match the status in ClickUp. Capital letters and extra spaces at the start or end do not matter.

4. Set fallback values

Enter the values Octanist uses when a task has no value:
  • Qualified Lead Fallback Value
  • Won Lead Fallback Value
The values are in your organization’s currency. Click Next Step.

5. Finalize setup

  1. Enter an Integration Name, for example ClickUp - 12345678.
  2. Click Complete Setup.
Octanist now creates a webhook in your ClickUp workspace. You do not need to add it yourself.

6. What happens next

When a task is updated in ClickUp, ClickUp notifies Octanist. Octanist only acts on status changes:
  1. Octanist reads the task and its email, phone and currency custom fields.
  2. If the new status matches one of your mapped statuses, Octanist looks for the lead by email first, then phone.
  3. The lead gets the new status. Qualified and won leads get the task’s currency value when it is above 0. Otherwise Octanist uses your fallback value.
  4. Qualified and won updates are sent to your connected ad platforms.
Status changes only move a lead forward. A won or lost lead is not changed again, and a qualified lead cannot be qualified twice. If no lead matches yet, Octanist keeps the update for up to 30 days. It is applied when a matching lead comes in. When several leads match the same email or phone, the setting under Settings > Lead Updates decides which lead is updated. When you remove the integration, Octanist also deletes the webhook in ClickUp.

7. Common problems

Setup fails when you click Complete Setup. Octanist could not create the webhook in ClickUp. Check the API token and Workspace ID. A task changes status but the lead does not update.
  • Check that the status name matches one of your mapped statuses.
  • Check that the task has an email or phone custom field filled in. Tasks without contact details are skipped.
  • Check that the email or phone matches the lead in Octanist.
A won update is rejected. A lead can only be marked as won with a value above 0. Add a currency value to the task or set a won fallback value above 0. If you need help, contact support@octanist.com.