×

How to Post Threaded Comments in ClickUp

/ ClickUp / By

How to Post Threaded Comments with the ClickUp API

The ClickUp API lets you programmatically add rich threaded comments to tasks and subtasks so your workflows stay synchronized between ClickUp and your own applications. This guide explains how to use the Create Threaded Comment endpoint step by step.

You will learn how to build the request, which fields are required, and how to handle optional features like attachments, tags, and notifications.

Understanding the ClickUp Create Threaded Comment Endpoint

The Create Threaded Comment operation allows you to add a new comment directly to a specific task or subtask. Each comment becomes part of a thread, making it easier to keep discussions organized in ClickUp.

At a high level, you will:

  • Identify the task where you want to add a comment.
  • Call the threaded comment endpoint with the task ID in the URL.
  • Provide comment details in a JSON request body.
  • Send the request with the correct authentication header.

Official reference documentation is available on the ClickUp Developer site here: Create Threaded Comment API reference.

Prerequisites for Using the ClickUp Comment API

Before you create threaded comments through the ClickUp API, make sure you have the following:

  • An active ClickUp workspace and access to the relevant space, folder, and list.
  • A valid ClickUp API token with permission to view and edit tasks.
  • The ID of the task or subtask where the comment will be posted.
  • An HTTP client such as cURL, Postman, or any programming language with HTTP support.

Access tokens are passed as headers in every call. Keep your token secure and never expose it in client-side code.

ClickUp Threaded Comment Endpoint URL and Method

The Create Threaded Comment operation uses an HTTP POST request. The endpoint follows this pattern:

POST https://api.clickup.com/api/v2/task/{task_id}/comment

Replace {task_id} with the actual ID of the task or subtask in your ClickUp workspace. The same structure applies whether your target is a parent task or a nested task.

Required Request Headers for ClickUp

Your request must include at least the following headers:

  • Authorization: Your personal or app ClickUp API token.
  • Content-Type: application/json

Example headers:

Authorization: <your_clickup_token>
Content-Type: application/json

Request Body Structure for ClickUp Threaded Comments

The request body for the ClickUp Create Threaded Comment endpoint is JSON. It can contain required and optional fields depending on what you want to achieve.

Common Request Body Fields

Key fields typically supported for a threaded comment request include:

  • comment_text: The main text of your comment. This is usually required so the comment is not empty.
  • assignee: A user ID to assign the comment to, if supported in your workspace and plan.
  • notify_all: Boolean flag to notify watchers or specific users.
  • attachments: Array of attachment objects or IDs, depending on your integration flow.
  • tags: Optional labels you may use to categorize the comment.

Consult the official endpoint description for the exact field names, types, and any constraints, as these may evolve.

Sample JSON Body for a ClickUp Comment

The structure below illustrates a typical JSON body used to create a threaded comment in ClickUp:

{
  "comment_text": "Review the latest requirements document and add your feedback.",
  "assignee": 123456,
  "notify_all": true
}

This would post a comment, optionally assign it to a specific user, and notify watchers according to your workspace configuration.

Step-by-Step: Create a Threaded Comment in ClickUp

Follow these steps to create a threaded comment programmatically with the ClickUp API.

Step 1: Retrieve the Task ID from ClickUp

First identify the task_id. You can obtain it by:

  • Copying it from the ClickUp task URL in your browser.
  • Fetching tasks via the List Tasks endpoint in the API.
  • Storing it when you originally created the task through the API.

Step 2: Build the Endpoint URL

Insert the task ID into the endpoint template:

https://api.clickup.com/api/v2/task/<task_id>/comment

For example, if your task ID is abc123, the full URL becomes:

https://api.clickup.com/api/v2/task/abc123/comment

Step 3: Prepare Headers and Authentication

Set up the HTTP headers with your ClickUp API token:

Authorization: <your_clickup_token>
Content-Type: application/json

Ensure the token has permission for the workspace and space that contain the target task.

Step 4: Craft the JSON Request Body

Create your JSON payload. At minimum, provide meaningful comment text:

{
  "comment_text": "Please confirm that all acceptance criteria are covered in this task.",
  "notify_all": false
}

You can expand this with optional fields described in the API reference, such as assignees or notification preferences.

Step 5: Send the POST Request to ClickUp

Use any HTTP client to send the POST request. Here is an example using cURL:

curl -X POST 
  "https://api.clickup.com/api/v2/task/<task_id>/comment" 
  -H "Authorization: <your_clickup_token>" 
  -H "Content-Type: application/json" 
  -d '{
    "comment_text": "Sprint review scheduled for Friday at 3 PM.",
    "notify_all": true
  }'

If successful, the API responds with details about the new comment, such as its ID, creation time, and associated task.

Handling Responses from the ClickUp API

When you call the Create Threaded Comment endpoint, ClickUp returns a JSON response object. While the exact schema is described in the reference, you should pay attention to:

  • Comment ID: Use this to update, reference, or delete the comment later.
  • Task reference: Confirms the comment is attached to the correct task.
  • Timestamps: Useful for auditing and displaying activity in your own UI.
  • Error messages: Help you diagnose invalid fields or permission issues.

Always validate HTTP status codes before processing the response body.

Common Error Scenarios in ClickUp Comment Calls

Typical issues when posting threaded comments include:

  • Missing or invalid Authorization header.
  • Incorrect or nonexistent task_id.
  • Malformed JSON in the request body.
  • Insufficient permissions for the workspace, list, or task.

Log the status code and error message returned by the ClickUp API for easier debugging.

Best Practices for Using Threaded Comments in ClickUp

To keep collaboration efficient, follow these practices when using the ClickUp comment endpoint:

  • Keep comment_text clear, concise, and action-oriented.
  • Use notify_all thoughtfully to prevent notification overload.
  • Standardize tags or prefixes in your comment text for automated parsing.
  • Store returned comment IDs if you plan to synchronize or modify comment threads later.

Structuring your comments carefully helps both your team and any connected systems interpret ClickUp activity consistently.

Integrating ClickUp Comments into Your Workflow

Beyond a single call, you can integrate threaded comments into broader processes. For example:

  • Automatically log deployment results by posting build summaries to related tasks.
  • Send customer feedback from a support system into the appropriate ClickUp task thread.
  • Trigger status updates or reminders as comments based on external events.

For more strategic guidance on building integrations and automation around the ClickUp platform, you can review consulting resources such as Consultevo, which covers broader workflow design and implementation topics.

Next Steps with the ClickUp API

Once you are comfortable posting threaded comments, explore additional task endpoints to create tasks, update fields, or manage watchers. Combining these operations allows you to build robust automation that keeps ClickUp in sync with your other tools.

Always refer to the latest official documentation for full parameter lists, field types, and examples: ClickUp Create Threaded Comment reference.

By following the steps in this guide and using the reference documentation together, you can reliably create threaded comments via the ClickUp API and embed collaborative updates directly into your custom applications.

Need Help With ClickUp?

If you want expert help building, automating, or scaling your ClickUp workspace, work with ConsultEvo — trusted ClickUp Solution Partners.

Get Help

“`

Verified by MonsterInsights