Skip to main content
Every task is required to be created in a specific workspace, and this workspace cannot be changed once set. The workspace need not be set explicitly if you specify projects or a parent task instead.

​
Parameters​

ParameterDescription
Assignee IDGid of a user.
Due OnThe localized date on which this task is due, or null if the task has no due date. This takes a date with YYYY-MM-DD format and should not be used together with due_at.
NameName of the task. This is generally a short sentence fragment that fits on a line in the UI for maximum readability. However, it can be longer.
Project IDsCreate-Only Array of project gids. In order to change projects on an existing task use addProject and removeProject.
Workspace IDGid of a workspace.

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