Create a task in a workspace, project or under a parent task.

Note: You must provide one of these parameters:

  • Workspace
  • Project IDs
  • Parent Task ID

External Documentation

To 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.
NameThe name of the task.
NotesInformation associated with the task.
Parent Task IDThe ID of an existing task. The newly created task will be added as a subtask of this parent task.
Project IDsA comma-separated list of project IDs to add the task to.
Start AtDate and time on which work begins for the task.
WorkspaceThe workspace global ID.

​
Advanced Parameters

ParameterDescription
Approval StatusThe approval status of this task.This parameter is synchronized with the Completed parameter, meaning pending translates to false while approved, rejected, and changes_requested translate to true. If you set the Completed parameter to true, this parameter will be set to approved.
CompletedWhen checked, the task is currently marked complete.This parameter is synchronized with the Approval Status parameter, meaning that if this parameter is checked, the Approval Status parameter will automatically be set to approved.
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 Task with Asana and Send Results Via Email

Preview this Workflow on desktop

Was this page helpful?