> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Task

Create a new task.

<Note>
  External Documentation

  To learn more, visit the [ClickUp documentation](https://clickup.com/api/clickupreference/operation/CreateTask/).
</Note>

## Basic Parameters

<div className="integrations-table">
  | 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.<br /><br />To get the list ID:<br />\* Use the action `Get Lists`.<br />\* Or, get it from the ClickUp platform:<br />  1. In the Sidebar, hover over the List and click the ellipsis ... menu.<br />  2. Select Copy link.<br />  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.<br /><br />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).                                                                                                                                                                                                                                                                                                              |
</div>

## Advanced Parameters

<div className="integrations-table">
  | Parameter                    | Description                                                                                                                                                            |
  | ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | Check Required Custom Fields | When creating a task via API any required Custom Fields are ignored by default (false).<br />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.                                                                                        |
</div>

## Example Output

```json theme={"dark"}
{
	"id": "<string>",
	"custom_id": null,
	"custom_item_id": 2,
	"name": "<string>",
	"text_content": "<string>",
	"description": "<string>",
	"status": {
		"id": "<string>",
		"status": "<string>",
		"color": "<string>",
		"orderindex": 18,
		"type": "<string>"
	},
	"orderindex": "<string>",
	"date_created": "<string>",
	"date_updated": "<string>",
	"date_closed": "<string>",
	"date_done": "<string>",
	"archived": false,
	"creator": {
		"id": 64998479,
		"username": "<string>",
		"color": "<string>",
		"email": "<string>",
		"profilePicture": null
	},
	"assignees": [],
	"group_assignees": [],
	"watchers": [
		{
			"id": 112918707,
			"username": "<string>",
			"color": "<string>",
			"initials": "<string>",
			"email": "<string>",
			"profilePicture": null
		}
	],
	"checklists": [],
	"tags": [],
	"parent": null,
	"top_level_parent": null,
	"priority": null,
	"due_date": null,
	"start_date": null,
	"points": null,
	"time_estimate": null,
	"time_spent": 0,
	"custom_fields": [
		{
			"id": "<string>",
			"name": "<string>",
			"type": "<string>",
			"type_config": {
				"options": [
					{
						"id": "<string>",
						"name": "<string>",
						"color": "<string>",
						"orderindex": 2
					},
					{
						"id": "<string>",
						"name": "<string>",
						"color": "<string>",
						"orderindex": 2
					}
				]
			},
			"date_created": "<string>",
			"hide_from_guests": false,
			"required": false
		},
		{
			"id": "<string>",
			"name": "<string>",
			"type": "<string>",
			"type_config": {},
			"date_created": "<string>",
			"hide_from_guests": false,
			"required": false
		}
	],
	"dependencies": [],
	"linked_tasks": [
		{
			"task_id": "<string>",
			"link_id": "<string>",
			"date_created": "<string>",
			"userid": "<string>",
			"workspace_id": "<string>"
		}
	],
	"locations": [],
	"team_id": "<string>",
	"url": "<string>",
	"sharing": {
		"public": false,
		"public_share_expires_on": null,
		"public_fields": [
			"<string>",
			"<string>"
		],
		"token": null,
		"seo_optimized": false
	},
	"permission_level": "<string>",
	"list": {
		"id": "<string>",
		"name": "<string>",
		"access": true
	},
	"project": {
		"id": "<string>",
		"name": "<string>",
		"hidden": false,
		"access": true
	},
	"folder": {
		"id": "<string>",
		"name": "<string>",
		"hidden": false,
		"access": true
	},
	"space": {
		"id": "<string>"
	}
}
```

## Workflow Library Example

[Create Task with Clickup and Send Results Via Email](https://library.blinkops.com/workflows/create-task-with-clickup-and-send-results-via-email)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/create-task-with-clickup-and-send-results-via-email/canvas" />
</div>