tasks:write scope is required to run this action.
External DocumentationTo learn more, visit the Asana documentation.
Basic Parameters
| Parameter | Description |
|---|---|
| Assignee ID | The global ID of the user to assign the task to. |
| Due At | The date and time on which this task is due. |
| Include Fields | A comma-separated list of properties to include in the response. |
| Name | The name of the task. |
| Notes | Information associated with the task. |
| Parent Task | The GID of the parent task to which the subtask will be added. |
| Project IDs | A comma-separated list of project IDs to add the task to. |
| Start At | The date and time on which work begins for the task. |
| Workspace | The global ID of the workspace that will contain the subtask. |
Advanced Parameters
| Parameter | Description |
|---|---|
| Completed | Select to mark the task complete. |
| Followers | A comma-separated list of identifying users. These can either be the string “me”, an email, or the global ID of a user. |
| Liked | When checked, the task is liked by the authorized user. |
| Resource Subtype | The 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. |
| Tags | A 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"
}
}
}