Create Tasks, Track Goals And Get Notified Of Changes With ClickUp

If your team plans its work in ClickUp, a lot of that work starts somewhere else: a customer email, a form submission, a failed order. Retyping each one into a task is slow, and nobody remembers to update the goal at the end of the week. ClickUp exposes its tasks, Goals and notifications through an API, so your other tools, or an AI assistant, can create and update the work for you.

What ClickUp does

ClickUp is a work management platform: tasks, Lists, Folders, Spaces, Docs, Chat, Goals, time tracking, dashboards and automations in one Workspace. It publishes a public REST API in two versions at once, v2 with 138 operations covering the broad surface and v3 with 35 operations for Chat, Docs, attachments, audit logs and access controls. ClickUp also runs a remote MCP server, so AI assistants can work with a Workspace directly.

What you can get done

Project Management

Tasks are the unit of work in ClickUp, and they live in Lists. These calls let anything that knows about work turn it into a task, and keep it current.

• POST /v2/list/{list_id}/task creates a new task in a List.
• GET /v2/list/{list_id}/task lists the tasks in a List.
• GET /v2/task/{task_id} returns one task’s details and attachments.
• PUT /v2/task/{task_id} changes a task’s fields, such as its status or priority.

Strategy Execution Management

Strategy execution is the connection between daily tasks and the bigger outcomes you are aiming for. In ClickUp those outcomes are Goals, each measured by Targets.

• GET /v2/team/{team_id}/goal lists the Goals in a Workspace.
• POST /v2/team/{team_id}/goal creates a Goal with owners and a due date.
• GET /v2/goal/{goal_id} returns a Goal and its Targets.
• PUT /v2/goal/{goal_id} renames a Goal or changes its due date.

Webhook & Event Subscription Management

A webhook is ClickUp calling your software the moment something changes, instead of your software asking over and over.

• POST /v2/team/{team_id}/webhook subscribes your own URL to Workspace events, such as task changes in one List.
• GET /v2/team/{team_id}/webhook lists the webhooks you have set up.
• PUT /v2/webhook/{webhook_id} changes which events a webhook listens for.
• DELETE /v2/webhook/{webhook_id} stops a webhook.

Identity & Access Management

Not every List should be visible to everyone, especially when clients or contractors share a Workspace.

• PATCH /api/v3/workspaces/{workspace_id}/{object_type}/{object_id}/acls changes privacy and sharing on a Space, Folder, List or task.

Ask for it in plain language

ClickUp has 34 phrasing overlays on APIs.io. They map plain questions to the operation that answers them, so an AI assistant knows which call to make. These are the kinds of questions they cover:

• What do I need to send to add a new task to a List using the v2 endpoint?
• How can I change a task’s status or priority through the v2 update endpoint?
• How do I set up a new Goal with owners and a due date through v2?
• Can I get notified at my own URL when tasks change in one List?
• How do I make a Space, Folder, List or task private?

The ClickUp ACLs API phrasing overlay is a good one to look at first.

Getting started

ClickUp is freemium with self-serve signup. Plans are in the pricing section of its APIs.io profile; as one example, Free Forever is listed at $0. Start with the tasks guide in ClickUp’s developer documentation.

The ClickUp profile on APIs.io lists every API, including the Comments API, the Goals API and the Folders API. The first thing worth automating is turning incoming requests into tasks, because that is where the retyping happens.