ClickUp API - Tasks, Projects, Spaces & Time Tracking

Manage your ClickUp workspace programmatically. Create and update tasks, organize projects and spaces, track time, add comments, and automate your entire project management workflow.

Features

Workspace & Organization

• list_workspaces - List all workspaces (teams) you have access to
• list_spaces - List spaces within a workspace
• list_folders - List folders within a space
• list_lists - List task lists within a folder or space
• list_statuses - List available statuses for a list

Task Management

• list_tasks - List tasks in a list with filters
• get_task - Get detailed task information
• create_task - Create a new task with all properties
• update_task - Update task name, status, priority, assignees, due date
• delete_task - Delete a task

Collaboration

• list_comments - List comments on a task
• create_comment - Add a comment to a task
• list_members - List workspace members
• get_user - Get current user information

Time Tracking

• list_time_entries - List time entries for a task or workspace
• create_time_entry - Log time against a task

Organization

• list_tags - List available tags in a space

Use Cases

• Task Automation - Auto-create tasks from forms, emails, or other triggers
• Reporting - Export task data for custom reports and dashboards
• Time Tracking - Sync time entries with billing or payroll systems
• Team Sync - Keep ClickUp in sync with other project tools
• Client Onboarding - Programmatically set up project templates
• Status Updates - Auto-update tasks based on external events
• Comment Bots - Add automated comments for notifications

Authentication

Get your personal API token from ClickUp:

1. Go to Settings (bottom left)
2. Click on "Apps"
3. Generate or copy your API token

For OAuth apps, use the OAuth flow described in ClickUp's developer docs.

ClickUp Hierarchy

Workspace (Team)
  └── Space
        └── Folder (optional)
              └── List
                    └── Task
                          └── Subtask

Output Format

{
  "task": "list_tasks",
  "success": true,
  "results": [
    {
      "id": "abc123",
      "name": "Design homepage mockup",
      "status": {
        "status": "in progress",
        "color": "#4194f6"
      },
      "priority": {
        "priority": "high",
        "color": "#ffcc00"
      },
      "assignees": [
        { "id": "123", "username": "john", "email": "john@example.com" }
      ],
      "due_date": "1706659200000",
      "tags": ["design", "urgent"],
      "time_spent": 3600000
    }
  ],
  "count": 1,
  "timestamp": "2024-01-20T14:30:00Z"
}

Task Priorities

Value	Priority
1	Urgent
2	High
3	Normal
4	Low

Pricing

$0.01 per query (all tasks)

Rate Limits

Rate limits depend on your ClickUp plan:

• Free/Unlimited/Business: 100 requests/minute
• Business Plus: 1,000 requests/minute
• Enterprise: 10,000 requests/minute

Security Notes

• Personal API tokens have full account access
• Use OAuth for user-delegated access in apps
• Never expose API tokens in client-side code