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