ClickUp Connector

Connect Zenmako to ClickUp to manage tasks, spaces, and checklists. This enables AI to view workspace structure, create and update tasks, add comments, and track progress with checklists.

Getting Your API Token

ClickUp uses API tokens for authentication. Follow these steps to generate one:

  • Log in to your ClickUp account
  • Click your avatar in the bottom-left corner
  • Select Settings
  • In the left sidebar, click Apps
  • Scroll down to the API Token section
  • Click Generate (or Regenerate if you have an existing token)
  • Copy the token immediately

    • Store your token securely. The token has access to all workspaces and data associated with your ClickUp account.

    Connecting ClickUp

  • Navigate to the Connections page in Zenmako
  • Click Add Connection and select ClickUp
  • Enter your credentials:
    • - API Token: Paste the API token you generated
  • Click Save
  • Click Test Connection to verify the setup works

    • If the test succeeds, your ClickUp connection is ready to use.

    Available Actions

    ActionDescription
    getTasksGet tasks from a ClickUp list with optional filters (archived, statuses, assignees, tags, dates)
    getTaskGet details of a specific ClickUp task by ID
    createTaskCreate a new task in a ClickUp list with name, description, assignees, priority, due date, and more
    updateTaskUpdate a ClickUp task (status, assignee, due date, priority, description, etc.)
    getFilteredTeamTasksFind tasks across the entire ClickUp workspace with filters (spaces, lists, statuses, assignees, tags)
    getSpacesGet spaces from a ClickUp workspace to see workspace structure
    getSpaceGet details of a specific ClickUp space
    getListsGet lists from a ClickUp folder
    getTaskCommentsRead comments on a ClickUp task
    createTaskCommentAdd an update or comment to a ClickUp task
    createChecklistAdd a checklist to a ClickUp task
    createChecklistItemAdd an item to a ClickUp checklist
    editChecklistItemMark a ClickUp checklist item as done or edit it

    Example Prompts

    Try these prompts to interact with your ClickUp data:

  • "Show me all tasks in the Sprint Backlog list"
  • "What tasks are assigned to me in the Product Development space?"
  • "Create a task called 'Review design mockups' with high priority and a due date of Friday"
  • "Move the 'API integration' task to In Progress status"
  • "Add a comment to the 'Bug fix' task saying 'Fixed in commit abc123'"
  • "Create a checklist called 'Launch Checklist' on the release task with items for QA, documentation, and deployment"

    • Common Issues

    "Invalid API token" or "Unauthorized" error

    This typically means your token is invalid or has been revoked. Solutions:

  • Verify you copied the complete token without extra spaces
  • Check that the token has not been regenerated in ClickUp's Settings
  • Generate a new token if needed

    • Cannot find workspace or team ID

    Some actions like getFilteredTeamTasks require a team/workspace ID. To find your team ID:

  • Use the getSpaces action first to retrieve workspace information
  • The team ID is typically visible in ClickUp URLs (e.g., https://app.clickup.com/1234567/... where 1234567 is the team ID)