clickup_create_task
Create a task in a ClickUp List with assignees, tags, priority, due dates, markdown description, subtask links, and custom fields. Specify the List ID and task name to add a new task.
Instructions
Create a task inside a List.
Calls POST /list/{list_id}/task. Supports the full create surface: assignees
and group assignees, tags, status, priority, due/start dates (unix ms), time
estimate, sprint points, a markdown or plain description, custom-field values,
subtask creation via parent, and a custom task type via custom_item_id.
When to Use:
To add a new task (or a subtask, by setting
parent) to a known List.
When NOT to Use:
To change an existing task — use
clickup_update_task.To copy a predefined template — use
clickup_create_task_from_template.
Returns: A confirmation string with the new task's name, id, and URL.
Examples:
Minimal:
params = {"list_id": "901", "name": "Draft spec"}Rich:
params = {"list_id": "901", "name": "Ship v2", "markdown_content": "## Goal\n...", "assignees": [123], "priority": 2, "due_date": 1735689600000, "due_date_time": true, "tags": ["release"], "custom_fields": [{"id": "abc", "value": "done"}]}
Error Handling: 400 usually means an unknown status/tag or a malformed custom_fields entry; 404 means the List id is wrong.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |