Skip to main content
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 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.
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 AtThe date 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.
CompletedSelect to mark the task 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": {
		"gid": "<string>",
		"num_likes": 2,
		"num_hearts": 0,
		"workspace": {
			"gid": "<string>",
			"resource_type": "<string>",
			"name": "<string>"
		},
		"start_at": null,
		"start_on": null,
		"resource_subtype": "<string>",
		"due_at": null,
		"due_on": null,
		"completed_at": null,
		"assignee_status": "<string>",
		"completed": false,
		"actual_time_minutes": 0,
		"assignee": null,
		"notes": "<string>",
		"name": "<string>",
		"modified_at": "2009-01-17T19:48:46.475Z",
		"created_at": "2000-01-02T11:42:43.230Z",
		"resource_type": "<string>",
		"projects": [
			{
				"gid": "<string>",
				"resource_type": "<string>",
				"name": "<string>"
			}
		],
		"tags": [],
		"parent": null,
		"likes": [],
		"hearts": [],
		"liked": false,
		"hearted": false,
		"memberships": [
			{
				"project": {
					"gid": "<string>",
					"resource_type": "<string>",
					"name": "<string>"
				},
				"section": {
					"gid": "<string>",
					"resource_type": "<string>",
					"name": "<string>"
				}
			}
		],
		"permalink_url": "<string>",
		"followers": [
			{
				"gid": "<string>",
				"resource_type": "<string>",
				"name": "<string>"
			}
		],
		"custom_fields": [
			{
				"gid": "<string>",
				"resource_type": "<string>",
				"display_value": null,
				"enabled": true,
				"is_formula_field": false,
				"name": "<string>",
				"type": "<string>",
				"resource_subtype": "<string>",
				"enum_value": null,
				"enum_options": [
					{
						"gid": "<string>",
						"resource_type": "<string>",
						"enabled": true,
						"name": "<string>",
						"color": "<string>"
					},
					{
						"gid": "<string>",
						"resource_type": "<string>",
						"enabled": true,
						"name": "<string>",
						"color": "<string>"
					}
				],
				"created_by": {
					"gid": "<string>",
					"resource_type": "<string>",
					"name": "<string>"
				}
			}
		]
	}
}

​
Workflow Library Example

Create Task with Asana and Send Results Via Email
Workflow LibraryPreview this Workflow on desktop
⌘I