Skip to main content
Create a new task.
External DocumentationTo learn more, visit the ClickUp documentation.

​
Basic Parameters

ParameterDescription
AssigneesA comma separated list of the assignees IDs to add to the task.
Custom FieldsThe custom fields values to add to the task.
DescriptionThe description of the task.
Folder IDThe ID of the folder.
List IDThe 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 TaskAdd 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.
PriorityThe priority of the task.
Space IDThe ID of the space.
StatusThe status of the task. For example Open.
TagsA comma separated list of the tags names to add to the task.
Task Links ToInclude a task ID to create a linked dependency with your new task.
Task NameThe name of the task.
Team IDThe ID of the team (Workspace team type).

​
Advanced Parameters

ParameterDescription
Check Required Custom FieldsWhen 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 IDsIf you want to reference a task by its custom task id, this value must be true.

​
Example Output

{
	"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
Workflow LibraryPreview this Workflow on desktop