ClickUp API 2.0
Build your own custom integrations and ClickUp apps with our public Application Programming Interface (API).
Explore the ClickUp API
Explore what's possible with the ClickUp API.
- Read our API docs in the left sidebar to learn about the ClickUp API.
- View and try individual endpoints and parameters by browsing the Reference section in the left sidebar.
Try the ClickUp API in your web browser
Try using our API with your ClickUp account and Workspaces, or use a mock server to see generic information.
You can copy an example request in a variety of coding languages.
Sample Application
Check out our API v2 sample app on GitHub to kickstart your project.
Authentication
To use the ClickUp API, you must authenticate every request.
For personal use, authenticate with your personal API token.
For apps or integrations that other people use, use the OAuth flow, allowing users to authorize Workspaces for your app.
Include the token in the Authorization header of your requests.
Both methods ensure that you and your users only have access to the information permitted by ClickUp.
Download the Postman collection
Start working with the ClickUp API in just a few clicks!
You can view all of the ClickUp API endpoints using our public collection available through Postman, which is an app you can use to test and work with APIs.
- View our Postman Collection.
- Fork the collection to create a copy in your own Postman workspace.
- Make your first request to the ClickUp API!
Demo App
Have a look at our demo app that uses the ClickUp API to create a custom integration. It covers a simple ClickUp to ClickUp integration build on OAuth, Webhooks and the API.
https://github.com/clickup/clickup-APIv2-demo/
Rate limits
The ClickUp API enforces request rate limits per token. Rate limits vary depending on your Workspace Plan.
Plan limits
API endpoints vary depending on your plan.
GET endpoints
GET endpoints require a body. If left blank, the API request will fail.