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
- Prepare ClickUp
- Enter your credentials
- Map your statuses
- Set fallback values
- Finalize setup
- What happens next
- Common problems
1. Prepare ClickUp
- In ClickUp, open your settings and go to Apps. Copy your API Token, or generate one.
- Find your Workspace ID. ClickUp’s API documentation calls this the Team ID.
- Make sure the tasks for your leads have an email or phone custom field filled in.
2. Enter your credentials
- In Octanist, go to Integrations and click Add integration.
- Find ClickUp and click Set up.
- Enter your API Token and Workspace ID.
- 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.
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
5. Finalize setup
- Enter an Integration Name, for example ClickUp - 12345678.
- Click Complete Setup.
6. What happens next
When a task is updated in ClickUp, ClickUp notifies Octanist. Octanist only acts on status changes:- Octanist reads the task and its email, phone and currency custom fields.
- If the new status matches one of your mapped statuses, Octanist looks for the lead by email first, then phone.
- 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.
- Qualified and won updates are sent to your connected ad platforms.
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.