# ClickUp Integration Connect your ClickUp tasks with TickUp to combine powerful project management with day-first scheduling. The ClickUp integration lets you link individual tasks while maintaining each tool's strengths. > [!quote] Best of Both Worlds > Use ClickUp for project management and TickUp for ==daily scheduling==—each tool doing what it does best. ## How ClickUp Integration Works The ClickUp integration creates **task links** rather than full synchronization: ### Task Linking System - **TickUp task connects to ClickUp task**: Create a relationship between tasks in both tools - **One-way updates**: Changes in ClickUp appear in TickUp, but not vice versa - **Maintain context**: Click through to full ClickUp task details when needed - **Day-first scheduling**: Use TickUp's time-based organization for ClickUp tasks ### Visual Integration When you link a ClickUp task, your TickUp task shows two sections: - **Top section**: TickUp task information (time tracking, scheduling, notes) - **Bottom section**: Connected ClickUp task details (status, assignees, project info) > [!tip] Integration Benefits > **Project context**: See ClickUp project details within TickUp > **Updated information**: ClickUp changes automatically appear in TickUp > **Time management**: Apply TickUp's capacity planning to ClickUp tasks > **Unified view**: Manage when to work on ClickUp tasks alongside other priorities ## Setting Up ClickUp Integration ### Initial Connection 1. **Open TickUp Settings**: Click the settings icon in your sidebar 2. **Go to Integrations**: Select the Integrations section 3. **Connect ClickUp**: Click on the ClickUp integration option 4. **Sign in to ClickUp**: Authenticate with your ClickUp account 5. **Grant permissions**: Allow TickUp to read your ClickUp tasks and lists ### Verifying Connection Once connected, you should see: - **ClickUp logo**: Appears in the right panel when editing tasks - **Connection status**: Shows as "Connected" in Integration Settings - **List access**: Ability to browse your ClickUp lists and tasks ## Linking TickUp Tasks to ClickUp Tasks ### Method 1: Browse by ClickUp List > [!success] Browse and Link Process > **1. Open a TickUp task**: Click to edit any TickUp task > **2. Click ClickUp logo**: Look for the ClickUp logo in the right panel > **3. Choose a list**: Select from your available ClickUp lists using the dropdown > **4. Browse tasks**: View all tasks in the selected ClickUp list > **5. Select task**: Click on the ClickUp task you want to link > **6. Confirm link**: The connection is created automatically ### Method 2: Search by ClickUp Task ID > [!success] Direct ID Linking > **1. Find ClickUp task ID**: Copy the task ID from ClickUp (found in task URL or details) > **2. Click ClickUp logo**: Access the integration panel > **3. Enter task ID**: Paste or type the ClickUp task ID > **4. Click enter**: TickUp will fetch and link the specific task ### Choosing Your Method - **Browse by list**: Best when you know which ClickUp project/list contains the task - **Search by ID**: Fastest when you have the specific ClickUp task open - **Mix both methods**: Use whatever feels most natural for each situation ## Understanding Linked Tasks ### What You See in TickUp Once linked, your TickUp task displays: > [!note] Linked Task Display **TickUp section** (top): > > - Your TickUp task title and notes > - Time tracking and planned time > - TickUp-specific labels and projects > - Energy state and scheduling 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 ### Data Flow Direction > [!warning] Important: One-Way Updates > **ClickUp → TickUp**: Changes in ClickUp automatically update in TickUp > **TickUp ≠ ClickUp**: Changes in TickUp do NOT sync back to ClickUp > **Independent tracking**: Time tracking and notes in TickUp stay in TickUp ## Working with Linked Tasks ### Daily Planning with ClickUp Tasks Use TickUp's day-first approach for your ClickUp tasks: 1. **Link ClickUp tasks**: Connect tasks you need to work on 2. **Set planned times**: Add time estimates in TickUp 3. **Schedule optimally**: Use TickUp's capacity planning for realistic daily schedules 4. **Track actual time**: Use TickUp's timer for accurate time tracking 5. **Maintain context**: Click through to ClickUp for full project details ### Managing Updates When ClickUp tasks change: - **Status updates**: New ClickUp status appears in TickUp automatically - **Description changes**: Updated ClickUp descriptions show in TickUp - **Due date changes**: Modified due dates appear in the linked view - **Assignment changes**: New assignees show in the ClickUp section ## Best Practices for ClickUp Integration ### Strategic Use - **High-priority ClickUp tasks**: Link tasks you need to schedule and track time for - **Active projects**: Focus on current ClickUp tasks rather than linking everything - **Time-sensitive work**: Use integration for tasks that need careful time management - **Review regularly**: Periodically assess which linked tasks are still relevant ### Workflow Integration - **Project planning in ClickUp**: Continue using ClickUp for project structure and collaboration - **Daily scheduling in TickUp**: Use TickUp for when to work on each ClickUp task - **Time tracking in TickUp**: Track actual time spent using TickUp's timer system - **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 TickUp - **Use each tool's strengths**: ClickUp for project management, TickUp for time management - **Minimize redundancy**: Only link ClickUp tasks you actively need to schedule ## Troubleshooting ClickUp Integration ### Connection Issues > [!warning] Common Connection Problems > **Can't see ClickUp lists**: Verify ClickUp connection in Integration Settings > **Tasks not loading**: Check internet connection and ClickUp permissions > **Updates not appearing**: Disconnect and reconnect the integration > **Missing tasks**: Ensure you have access to the ClickUp workspace and lists ### Linking Problems > [!warning] Task Linking Issues > **Can't find task by ID**: Verify the ClickUp task ID is correct and you have access > **Link not working**: Ensure both TickUp and ClickUp tasks exist and are accessible > **Wrong task linked**: Unlink and relink with the correct ClickUp task > **Missing information**: Check ClickUp permissions allow access to task details ### Performance Considerations - **Limit active links**: Too many linked tasks can slow down TickUp - **Regular cleanup**: Remove links to completed or irrelevant ClickUp tasks - **Batch operations**: Link multiple tasks at once rather than one-by-one when possible ## Integration Scenarios ### Project-Based Work Link specific ClickUp tasks from active projects to schedule them in TickUp while maintaining full project context in ClickUp. ### Sprint Planning Connect current sprint tasks from ClickUp to plan your daily work schedule using TickUp's capacity management. ### Client Work Link client-specific ClickUp tasks to track time accurately in TickUp while keeping client communication and project details in ClickUp. The ClickUp integration bridges the gap between project management and daily time management, letting you maintain your ClickUp workflows while gaining TickUp's powerful day-first scheduling capabilities. --- **Next:** Connect your calendar with [[Google Integration]].