ClickUp API: what you can do and how to use it with AI agents
The ClickUp API gives access to the account's work structure: spaces, folders, lists, tasks, comments and custom fields. Operations, product and agency teams that organize everything in ClickUp use it. Access is through a personal token or a registered OAuth app.
What the ClickUp API offers
Tasks
Create, update, assign and change the status of tasks and subtasks.
Spaces, folders and lists
Read and organize the account's work hierarchy.
Comments
Add and read comments on tasks and lists.
Custom fields
Read and fill in the fields the team created.
Time tracking
Record and query hours logged on tasks.
Webhooks
Alerts when a task is created, changed or completed.
How to access the ClickUp API
- With your company’s credentialsAccepts a personal token generated in the user's settings, or OAuth 2.0 with a registered app, which is the better choice when several users authorize.
- There are per-minute request limits, depending on the plan.
- Use a service account instead of a team member's personal token.
- Deleting tasks should stay outside the agent's permissions.
Official documentation: developer.clickup.com
What an iTeam agent does with the ClickUp API
WhatsApp request becomes a task
The agent receives the customer's request, creates the task in the right list with a due date and owner, and returns the tracking link.
Weekly project status
The agent reads the tasks in each list, flags delays and blockers and sends the summary to the manager.
Chasing stalled tasks
Tasks with no update for days get a comment from the agent asking the owner for the status.
Hours for billing
At month end, the agent adds up the time logged per client and prepares the basis for the invoice.
From the credential to the agent at work, with approval
Generate the token or the app
Create a token on a ClickUp service account or register an OAuth app, with access only to the spaces needed.
Store it in the vault and set the scope
Register the credential in the iTeam vault and define per agent which lists it reads and where it can create or edit tasks.
Start in a test list
Test in a separate list and switch the automation on in the real lists when the team approves the result.
Ready-made AI teams for this work
Management reporting team
Revenue, margin, pipeline and cash in one report, built from your systems, with a short note on what changed and why.
Inventory planning team
Stock, sales and lead times are checked every day. You get a reorder list per SKU and a warning about what is not selling.
Procurement and quotes team
Requests go out to suppliers, quotes come back into one table, and the approver sees price, terms and past orders before saying yes.
Logistics and deliveries team
Routes, drivers and delivery status in one place, with customers told about delays before they have to ask.
Questions about the ClickUp API
Is the ClickUp API free?
Generally yes: the API is available on ClickUp plans with no separate charge, with usage limits that vary by plan.
Do I need to write code to use the ClickUp API with iTeam?
Not necessarily. ClickUp is in iTeam's app catalog, and the deployment team sets up lists, fields and rules.
Can the agent fill in custom fields?
Yes, as long as it has access to the list. It is useful for writing the client, value or priority straight onto the task.
