Create Task
Create a new task.
External Documentation
To learn more, visit the ClickUp documentation.
Basic Parameters
Parameter | Description |
---|---|
Assignees | A comma separated list of the assignees IDs to add to the task. |
Custom Fields | The custom fields values to add to the task. |
Description | The description of the task. |
Folder ID | The ID of the folder. |
List ID | The ID of the list. To get the list ID: Use the action Get Lists .Or, get it from the ClickUp platform: 1. In the Sidebar, hover over the List and click the ellipsis ... menu. 2. Select Copy link. 3. Use the copied URL to find the listId. The listId is the number that follows /li in the URL. |
Parent Task | Add an existing task ID to create a subtask. The parent task ID you include cannot be a subtask, and must be in the same List specified in the List ID parameter. |
Priority | The priority of the task. |
Space ID | The ID of the space. |
Status | The status of the task. For example Open . |
Tags | A comma separated list of the tags names to add to the task. |
Task Links To | Include a task ID to create a linked dependency with your new task. |
Task Name | The name of the task. |
Team ID | The ID of the team (Workspace team type). |
Advanced Parameters
Parameter | Description |
---|---|
Check Required Custom Fields | When creating a task via API any required Custom Fields are ignored by default (false). You can enforce required Custom Fields by setting this parameter to true. |
Custom Task IDs | If you want to reference a task by its custom task id, this value must be true. |
Example Output
{
"id": "9hx",
"custom_id": null,
"custom_item_id": null,
"name": "New Task Name",
"text_content": "New Task Content",
"description": "New Task Content",
"markdown_description": "New Task Content",
"status": {
"status": "in progress",
"color": "#d3d3d3",
"orderindex": 1,
"type": "custom"
},
"orderindex": "1.00000000000000000000000000000000",
"date_created": "1567780450202",
"date_updated": "1567780450202",
"date_closed": null,
"date_done": null,
"creator": {
"id": 183,
"username": "John Doe",
"color": "#827718",
"profilePicture": "https://attachments-public.clickup.com/profilePictures/183_abc.jpg"
},
"assignees": [],
"archived": false,
"group_assignees": [],
"checklists": [],
"tags": [],
"parent": "abc1234",
"priority": null,
"due_date": null,
"start_date": null,
"points": 3,
"time_estimate": null,
"time_spent": null,
"custom_fields": [
{
"id": "0a52c486-5f05-403b-b4fd-c512ff05131c",
"name": "My Text Custom field",
"type": "text",
"type_config": {},
"date_created": "1622176979540",
"hide_from_guests": false,
"value": {
"value": "This is a string of text added to a Custom Field."
},
"required": true
}
],
"list": {
"id": "123"
},
"folder": {
"id": "456"
},
"space": {
"id": "789"
},
"url": "https://app.clickup.com/t/9hx"
}
Workflow Library Example
Create Task with Clickup and Send Results Via Email
Preview this Workflow on desktop