Skip to main content
Create a new subtask and add it to the parent task. Note: The tasks:write scope is required to run this action.
External DocumentationTo learn more, visit the Asana documentation.

​
Basic Parameters

ParameterDescription
Assignee IDThe global ID of the user to assign the task to.
Due AtThe date and time on which this task is due.
Include FieldsA comma-separated list of properties to include in the response.
NameThe name of the task.
NotesInformation associated with the task.
Parent TaskThe GID of the parent task to which the subtask will be added.
Project IDsA comma-separated list of project IDs to add the task to.
Start AtThe date and time on which work begins for the task.
WorkspaceThe global ID of the workspace that will contain the subtask.

​
Advanced Parameters

ParameterDescription
CompletedSelect to mark the task complete.
FollowersA comma-separated list of identifying users. These can either be the string “me”, an email, or the global ID of a user.
LikedWhen checked, the task is liked by the authorized user.
Resource SubtypeThe subtype of this resource.

Note: The Resource Subtype milestone represent a single moment in time. This means tasks with this subtype cannot have a Start Date.
TagsA comma-separated list of tag global IDs.

​
Example Output

{
	"data": {
		"approval_status": "pending",
		"assignee": {
			"gid": "12345",
			"name": "Greg Sanchez",
			"resource_type": "task"
		},
		"assignee_section": {
			"gid": "12345",
			"name": "Next Actions",
			"resource_type": "task"
		},
		"assignee_status": "upcoming",
		"completed": false,
		"completed_at": "2012-02-22T02:06:58.147Z",
		"completed_by": {
			"gid": "12345",
			"name": "Greg Sanchez",
			"resource_type": "task"
		},
		"created_at": "2012-02-22T02:06:58.147Z",
		"custom_fields": [
			{
				"created_by": {
					"gid": "12345",
					"name": "Greg Sanchez",
					"resource_type": "task"
				},
				"currency_code": "EUR",
				"custom_label": "gold pieces",
				"custom_label_position": "suffix",
				"date_value": {
					"date": "2024-08-23",
					"date_time": "2024-08-23T22:00:00.000Z"
				},
				"description": "Development team priority",
				"display_value": "blue",
				"enabled": true,
				"enum_options": [
					{
						"color": "blue",
						"enabled": true,
						"gid": "12345",
						"name": "Low",
						"resource_type": "task"
					}
				],
				"enum_value": {
					"color": "blue",
					"enabled": true,
					"gid": "12345",
					"name": "Low",
					"resource_type": "task"
				},
				"format": "custom",
				"gid": "12345",
				"has_notifications_enabled": true,
				"is_global_to_workspace": true,
				"multi_enum_values": [
					{
						"color": "blue",
						"enabled": true,
						"gid": "12345",
						"name": "Low",
						"resource_type": "task"
					}
				],
				"name": "Status",
				"number_value": 5.2,
				"precision": 2,
				"resource_subtype": "text",
				"resource_type": "task",
				"text_value": "Some Value",
				"type": "*Deprecated: new integrations should prefer the resource_subtype field.* The type of the custom field. Must be one of the given values.\n"
			}
		],
		"dependencies": [
			{
				"gid": "12345",
				"resource_type": "task"
			}
		],
		"dependents": [
			{
				"gid": "12345",
				"resource_type": "task"
			}
		],
		"due_at": "2019-09-15T02:06:58.147Z",
		"due_on": "2019-09-15",
		"external": {
			"data": "A blob of information",
			"gid": "my_gid"
		},
		"followers": [
			{
				"gid": "12345",
				"name": "Greg Sanchez",
				"resource_type": "task"
			}
		],
		"gid": "12345",
		"hearted": true,
		"hearts": [
			{
				"gid": "12345",
				"user": {
					"gid": "12345",
					"name": "Greg Sanchez",
					"resource_type": "task"
				}
			}
		],
		"html_notes": "\u003cbody\u003eMittens \u003cem\u003ereally\u003c/em\u003e likes the stuff from Humboldt.\u003c/body\u003e",
		"is_rendered_as_separator": false,
		"liked": true,
		"likes": [
			{
				"gid": "12345",
				"user": {
					"gid": "12345",
					"name": "Greg Sanchez",
					"resource_type": "task"
				}
			}
		],
		"memberships": [
			{
				"project": {
					"gid": "12345",
					"name": "Stuff to buy",
					"resource_type": "task"
				},
				"section": {
					"gid": "12345",
					"name": "Next Actions",
					"resource_type": "task"
				}
			}
		],
		"modified_at": "2012-02-22T02:06:58.147Z",
		"name": "Buy catnip",
		"notes": "Mittens really likes the stuff from Humboldt.",
		"num_hearts": 5,
		"num_likes": 5,
		"num_subtasks": 3,
		"parent": {
			"gid": "12345",
			"name": "Bug Task",
			"resource_subtype": "default_task",
			"resource_type": "task"
		},
		"permalink_url": "https://app.asana.com/0/resource/123456789/list",
		"projects": [
			{
				"gid": "12345",
				"name": "Stuff to buy",
				"resource_type": "task"
			}
		],
		"resource_subtype": "default_task",
		"resource_type": "task",
		"start_at": "2019-09-14T02:06:58.147Z",
		"start_on": "2019-09-14",
		"tags": [
			{
				"gid": "59746",
				"name": "Grade A"
			}
		],
		"workspace": {
			"gid": "12345",
			"name": "My Company Workspace",
			"resource_type": "task"
		}
	}
}

​
Workflow Library Example

Create Subtask with Asana and Send Results Via Email
Workflow LibraryPreview this Workflow on desktop