Create Task
Creating a new task is as easy as POSTing to the /tasks endpoint with a
data block containing the fields you’d like to set on the task. Any
unspecified fields will take on default values.
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
| Parameter | Description |
|---|---|
| Assignee ID | Gid of a user. |
| Due On | The 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. |
| Name | Name 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 IDs | Create-Only Array of project gids. In order to change projects on an existing task use addProject and removeProject. |
| Workspace ID | Gid 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
Preview this Workflow on desktop