# ClickUp Integration
Connect your ClickUp tasks to Zaphiri so project work in ClickUp has a realistic place in your day. The ClickUp integration links individual tasks, and each tool keeps doing its own job.
> [!quote] Each tool doing its job
> Use ClickUp for project management and Zaphiri for ==planning your day==. Each tool does what it is good at.
## How the ClickUp integration works
The ClickUp integration creates **task links** rather than a full sync:
### Task linking
- **A Zaphiri task connects to a ClickUp task**: the two tasks are linked across both tools
- **One-way updates**: changes in ClickUp appear in Zaphiri, but not the other way round
- **Keep the context**: open the full ClickUp task details when you need them
- **Day-first planning**: plan ClickUp tasks into your days in Zaphiri
### How a linked task looks
When you link a ClickUp task, your Zaphiri task shows two sections:
- **Top section**: Zaphiri task information (time tracking, planning, notes)
- **Bottom section**: the connected ClickUp task details (status, assignees, project info)
> [!tip] What you get
> **Project context**: see ClickUp project details inside Zaphiri
> **Up-to-date information**: ClickUp changes appear in Zaphiri on their own
> **Capacity planning**: plan ClickUp tasks against the time you really have
> **One view**: decide when to work on ClickUp tasks alongside your other priorities
## Setting up the ClickUp integration
![[integrations-task-section.png]]
ClickUp connects from **Settings → Integrations**, under Task Integration.
### Initial connection
1. **Open Zaphiri Settings**: select the settings icon in your sidebar
2. **Go to Integrations**: select the Integrations section
3. **Connect ClickUp**: select the ClickUp integration option
4. **Sign in to ClickUp**: sign in with your ClickUp account
5. **Grant permissions**: allow Zaphiri to read your ClickUp tasks and lists
### Checking the connection
Once connected, you should see:
- **ClickUp logo**: in the right panel when you edit tasks
- **Connection status**: shown as "Connected" in Integration Settings
- **List access**: you can browse your ClickUp lists and tasks
## Linking Zaphiri tasks to ClickUp tasks
### Method 1: Browse by ClickUp list
> [!success] Browse and link
> **1. Open a Zaphiri task**: select any Zaphiri task to edit it
> **2. Select the ClickUp logo**: look for the ClickUp logo in the right panel
> **3. Choose a list**: pick from your ClickUp lists in the dropdown. Each list shows its **total task count**, which updates as you search
> **4. Browse tasks**: view all tasks in the selected ClickUp list
> **5. Select a task**: select the ClickUp task you want to link
> **6. Link created**: the connection is created on its own
### Method 2: Search by ClickUp task ID
> [!success] Link by ID
> **1. Find the ClickUp task ID**: copy the task ID from ClickUp (in the task URL or details)
> **2. Select the ClickUp logo**: open the integration panel
> **3. Enter the task ID**: paste or type the ClickUp task ID
> **4. Press Enter**: Zaphiri fetches and links that task
### Choosing your method
- **Browse by list**: best when you know which ClickUp project or list holds the task
- **Search by ID**: fastest when you have the ClickUp task open
- **Use both**: use whichever suits the moment
## Understanding linked tasks
### What you see in Zaphiri
Once linked, your Zaphiri task shows:
> [!note] Linked task display **Zaphiri section** (top):
>
> - Your Zaphiri task title and notes
> - Time tracking and planned time
> - Zaphiri labels and projects
> - Energy label and planning information
>
> **ClickUp section** (bottom):
>
> - ClickUp task title and description
> - ClickUp project and list information
> - Status, assignees and due dates
> - Tags and custom fields from ClickUp
### Which way data flows
> [!warning] Important: one-way updates
> **ClickUp → Zaphiri**: changes in ClickUp update in Zaphiri on their own
> **Zaphiri ≠ ClickUp**: changes in Zaphiri do **not** sync back to ClickUp
> **Separate tracking**: time tracking and notes in Zaphiri stay in Zaphiri
## Working with linked tasks
### Daily Planning with ClickUp tasks
Use Zaphiri's day-first approach for your ClickUp tasks:
1. **Link ClickUp tasks**: connect the tasks you need to work on
2. **Set planned times**: add time estimates in Zaphiri
3. **Plan realistically**: use Zaphiri's capacity planning to fit tasks into your days
4. **Track actual time**: use Zaphiri's timer for accurate time tracking
5. **Keep the context**: open ClickUp for full project details
### Managing updates
When ClickUp tasks change:
- **Status updates**: the new ClickUp status appears in Zaphiri on its own
- **Description changes**: updated ClickUp descriptions show in Zaphiri
- **Due date changes**: changed due dates appear in the linked view
- **Assignment changes**: new assignees show in the ClickUp section
## Good practice for the ClickUp integration
### Choosing what to link
- **High-priority ClickUp tasks**: link the tasks you need to plan and track time for
- **Active projects**: focus on current ClickUp tasks rather than linking everything
- **Time-sensitive work**: link tasks that need careful time management
- **Review regularly**: check from time to time which linked tasks are still relevant
### Fitting it into how you work
- **Project planning in ClickUp**: keep using ClickUp for project structure and collaboration
- **Daily planning in Zaphiri**: use Zaphiri to decide when to work on each ClickUp task
- **Time tracking in Zaphiri**: track actual time spent with Zaphiri's timer
- **Status updates in ClickUp**: update task progress and status in ClickUp as usual
### Avoiding duplication
- **Don't recreate tasks**: link existing ClickUp tasks rather than recreating them in Zaphiri
- **Use each tool for its job**: ClickUp for project management, Zaphiri for planning your time
- **Keep it lean**: only link ClickUp tasks you actively need to plan
## Troubleshooting the ClickUp integration
### Connection issues
> [!warning] Common connection problems
> **Can't see ClickUp lists**: check the ClickUp connection in Integration Settings
> **Tasks not loading**: check your internet connection and ClickUp permissions
> **Updates not appearing**: disconnect and reconnect the integration
> **Missing tasks**: make sure you have access to the ClickUp workspace and lists
### Linking problems
> [!warning] Task linking issues
> **Can't find a task by ID**: check that the ClickUp task ID is correct and that you have access
> **Link not working**: make sure both the Zaphiri and ClickUp tasks exist and are accessible
> **Wrong task linked**: unlink and relink with the correct ClickUp task
> **Missing information**: check that your ClickUp permissions allow access to task details
### Performance
- **Limit active links**: too many linked tasks can slow Zaphiri down
- **Regular cleanup**: remove links to completed or irrelevant ClickUp tasks
- **Batch operations**: link several tasks at once rather than one by one, where you can
## Example uses
### Project-based work
Link specific ClickUp tasks from active projects to plan them in Zaphiri, while the full project context stays in ClickUp.
### Sprint planning
Connect current sprint tasks from ClickUp and plan your daily work with Zaphiri's capacity planning.
### Client work
Link client ClickUp tasks to track time accurately in Zaphiri, while client communication and project details stay in ClickUp.
The ClickUp integration connects project management with your daily plan. You keep your ClickUp workflows and add Zaphiri's day-first planning.
---
**Next:** Connect your calendar with [[Google|Google Integration]].