Skip to main content

Asana Component

Manage users, projects, and teams in your Asana workspace

Component key: asana

Description#

Asana is a web and mobile application designed to help teams organize, track, and manage their work.

Use the Asana component to manage users, projects, and teams in your Asana workspace.

A Note on Asana Pagination#

Asana's API is paginated. That means that their API will return up to 100 results for any query. If additional results are available, an Asana step will return an additional property, next_page alongside the data that is returned.

{  "data": {},  "next_page": {    "offset": "yJ0eXAiOiJKV1QiLCJhbGciOiJIRzI1NiJ9",    "path": "/tasks?project=1337&limit=5&offset=yJ0eXAiOiJKV1QiLCJhbGciOiJIRzI1NiJ9",    "uri": "https://app.asana.com/api/1.0/tasks?project=1337&limit=5&offset=yJ0eXAiOiJKV1QiLCJhbGciOiJIRzI1NiJ9"  }}

The offset returned from next_page can be used in a subsequent query to fetch additional results.

See Asana's docs for information about Asana's paginated API, and this quickstart for information on looping over a paginated API in Prismatic.

Asana Connections#

Asana Personal Access Token#

Developer personal access tokens can be used for development purposes, but you should use an OAuth 2.0 connection when you deploy your integration (so your users can log in with their accounts).

To generate an personal access token, log in to Asana and open app.asana.com/0/my-apps. Then, click + Create new token.

For more information on access tokens, refer to the Asana Docs.

InputNotesExample
Input
Personal Access Token
string
/ Required
Notes
Log in to https://app.asana.com/0/my-apps to fetch a personal access token for development purposes
Example
1/example

Asana OAuth 2.0 Connection#

To make API requests of Asana on behalf of your customers you need to create an "OAuth app" within Asana. Log in to Asana and then visit app.asana.com/0/my-apps.

  • Click Create new app
  • Give your app a name and agree to Asana's terms and conditions
  • Open OAuth from the left-hand menu and take note of the generated Client ID and Client secret
  • Click + Add redirect URL and enter https://oauth2.prismatic.io/callback

Finally, when creating your Asana integration update your Asana connection with the Client ID and Client secret that you noted.

InputDefaultNotes
Input
Authorize URL
string
/ Required
Hidden Field
Default
https://app.asana.com/-/oauth_authorize
Notes
The OAuth 2.0 Authorization URL for Asana
Input
Client ID
string
/ Required
Default
Notes
Generate from https://app.asana.com/0/my-apps/
Input
Client secret
password
/ Required
Default
Notes
Generate from https://app.asana.com/0/my-apps/
Input
Revoke URL
string
/ Required
Hidden Field
Default
https://app.asana.com/-/oauth_revoke
Notes
The OAuth 2.0 Revoke URL for Asana
Input
Scopes
string
Hidden Field
Default
Notes
Asana does not support granular scopes.
Input
Token URL
string
/ Required
Hidden Field
Default
https://app.asana.com/-/oauth_token
Notes
The OAuth 2.0 Token URL for Asana

Triggers#

Asana Webhook#

Handle and validate webhook requests from Asana | key: webhook

Actions#

Add Custom Field To Portfolio#

Add a custom field to an existing portfolio | key: addCustomFieldToPortfolio

InputDefaultNotesExample
Input
Connection
connection
/ Required
Default
 
Notes
 
Example
 
Input
Field ID
string
/ Required
Default
Notes
The unique identifier of the field
Example
843750385
Input
Insert After
string
Default
Notes
The ID of the field or section to insert this one insert after
Example
843750385
Input
Insert before
string
Default
Notes
The ID of the field or section to insert this one before
Example
843750385
Input
Is Important
boolean
/ Required
Default
true
Notes
Determines if the custom field will be marked as important
Example
 
Input
Portfolio ID
string
/ Required
Default
Notes
Provide the unique identifier of the portfolio.
Example
843750385

Output Example Payload#

{  "data": {    "data": {}  }}

Add Custom Field To Project#

Add a new Custom Field to an existing Project | key: addCustomFieldToProject

InputDefaultNotesExample
Input
Connection
connection
/ Required
Default
 
Notes
 
Example
 
Input
Field ID
string
/ Required
Default
Notes
The unique identifier of the field
Example
843750385
Input
Insert After
string
Default
Notes
The ID of the field or section to insert this one insert after
Example
843750385
Input
Insert before
string
Default
Notes
The ID of the field or section to insert this one before
Example
843750385
Input
Is Important
boolean
/ Required
Default
true
Notes
Determines if the custom field will be marked as important
Example
 
Input
Project ID
string
/ Required
Default
Notes
Provide the unique identifier of the project.
Example
375893453

Output Example Payload#

{  "data": {    "data": {      "gid": "1202476446247138",      "resource_type": "custom_field_setting",      "custom_field": {        "gid": "1202476274909067",        "resource_type": "custom_field",        "created_by": {          "gid": "1202467472237333",          "resource_type": "user",          "name": "Example User"        },        "resource_subtype": "multi_enum",        "type": "multi_enum",        "name": "Do you want these things?",        "enum_options": [          {            "gid": "1202476274909068",            "resource_type": "enum_option",            "enabled": true,            "name": "My First Option",            "color": "green"          },          {            "gid": "1202476274909069",            "resource_type": "enum_option",            "enabled": true,            "name": "My Second Option",            "color": "red"          },          {            "gid": "1202476274909070",            "resource_type": "enum_option",            "enabled": true,            "name": "My Third Option",            "color": "orange"          }        ]      },      "is_important": true,      "parent": {        "gid": "1202467472002605",        "resource_type": "project",        "name": "Brand redesign campaign"      },      "project": {        "gid": "1202467472002605",        "resource_type": "project",        "name": "Brand redesign campaign"      }    }  }}

Add Followers To Task#

Add followers to an existing task | key: addFollowersToTask

InputNotesExample
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
Followers List
string
Value List
Notes
For each item, provide the unique identifier of an existing userId.
Example
843750385
Input
Task ID
string
/ Required
Notes
Provide the unique identifier for the task.
Example
375893453

Output Example Payload#

{  "data": {    "data": {      "gid": "1202461451752271",      "resource_type": "task",      "created_at": "2022-06-16T21:17:30.519Z",      "name": "My task name",      "workspace": {        "gid": "1126509132283071",        "resource_type": "workspace"      },      "followers": [        {          "gid": "1202178852626547",          "resource_type": "user"        }      ]    }  }}

Add Tag To Task#

Add a tag to an existing task | key: addTagToTask

InputNotesExample
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
Tag ID
string
/ Required
Notes
The unique identifier of the tag
Example
843750385
Input
Task ID
string
/ Required
Notes
Provide the unique identifier for the task.
Example
375893453

Output Example Payload#

{  "data": {    "data": {}  }}

Add Task To Section#

Add an existing task to the given section of a project | key: addTaskToSection

InputNotesExample
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
Insert After
string
Notes
The ID of the field or section to insert this one insert after
Example
843750385
Input
Insert before
string
Notes
The ID of the field or section to insert this one before
Example
843750385
Input
Section ID
string
/ Required
Notes
The unique identifier of the section
Example
843750385
Input
Task ID
string
/ Required
Notes
Provide the unique identifier for the task.
Example
375893453

Output Example Payload#

{  "data": {    "data": {}  }}

Add User To Team#

Add an existing user to the given team | key: addUserToTeam

InputNotesExample
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
Team ID
string
/ Required
Notes
Provide the unique identifier of the team.
Example
843750385
Input
User ID
string
/ Required
Notes
The global ID of a user
Example
375893453

Output Example Payload#

{  "data": {    "data": {      "gid": "1202178854270530",      "resource_type": "team_membership",      "team": {        "gid": "1202178854270529",        "resource_type": "team",        "name": "Engineering"      },      "user": {        "gid": "1202178852626547",        "resource_type": "user",        "name": "Example User"      },      "is_guest": false    }  }}

Add User To Workspace#

Add a new user to the given workspace | key: addUser

InputNotesExample
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
User ID
string
/ Required
Notes
The global ID of a user
Example
375893453
Input
Workspace ID
string
/ Required
Notes
The gid of the workspace
Example
375893453

Output Example Payload#

{  "data": {    "data": {      "gid": "1126508793140155",      "resource_type": "user",      "name": "Example User",      "email": "user@example.com",      "photo": {        "image_21x21": "https://s3.amazonaws.com/profile_photos/1126508793140155.1126509132283075.joZwntHYCrotR7QnI82A_21x21.png",        "image_27x27": "https://s3.amazonaws.com/profile_photos/1126508793140155.1126509132283075.joZwntHYCrotR7QnI82A_27x27.png",        "image_36x36": "https://s3.amazonaws.com/profile_photos/1126508793140155.1126509132283075.joZwntHYCrotR7QnI82A_36x36.png",        "image_60x60": "https://s3.amazonaws.com/profile_photos/1126508793140155.1126509132283075.joZwntHYCrotR7QnI82A_60x60.png",        "image_128x128": "https://s3.amazonaws.com/profile_photos/1126508793140155.1126509132283075.joZwntHYCrotR7QnI82A_128x128.png"      }    }  }}

Add Users To Portfolio#

Add existing users to the given portfolio | key: addUserToPortfolio

InputNotesExample
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
Members
string
Value List
Notes
For each value, provide the user id of a member. These can either be the string 'me', an email, or the gid of a user.
Example
843750385
Input
Portfolio ID
string
/ Required
Notes
Provide the unique identifier of the portfolio.
Example
843750385

Output Example Payload#

{  "data": {    "data": {      "gid": "1202474374782519",      "resource_type": "portfolio",      "created_at": "2022-06-20T16:48:04.621Z",      "created_by": {        "gid": "1202467472237333",        "resource_type": "user",        "name": "Example User"      },      "owner": {        "gid": "1202467472237333",        "resource_type": "user",        "name": "Example User"      },      "name": "My Portfolio",      "public": true,      "members": [        {          "gid": "1202467472237333",          "resource_type": "user",          "name": "Example User"        },        {          "gid": "1202467584678838",          "resource_type": "user",          "name": "Developer Name"        }      ],      "custom_field_settings": [],      "workspace": {        "gid": "1202467471973207",        "resource_type": "workspace",        "name": "Example Workspace"      },      "permalink_url": "https://app.asana.com/0/portfolio/1202474374782519",      "color": "none",      "due_on": null,      "start_on": null,      "current_status_update": {        "gid": "1202475750145512",        "resource_type": "status_update",        "title": "This Portfolio of work is on track!"      }    }  }}

Add Users To Project#

Add an existing user to the given project | key: addUserToProject

InputNotesExample
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
Members
string
Value List
Notes
For each value, provide the user id of a member. These can either be the string 'me', an email, or the gid of a user.
Example
843750385
Input
Project ID
string
/ Required
Notes
Provide the unique identifier of the project.
Example
375893453

Output Example Payload#

{  "data": {    "data": {      "gid": "1202461834400501",      "resource_type": "project",      "created_at": "2022-06-16T22:59:28.974Z",      "modified_at": "2022-06-16T22:59:31.222Z",      "members": [        {          "gid": "1202178852626547",          "resource_type": "user"        }      ],      "owner": {        "gid": "1202178852626547",        "resource_type": "user"      },      "due_on": null,      "current_status": null,      "public": true,      "name": "My new project name",      "notes": "My new project notes",      "html_notes": "<body>My new project notes</body>",      "archived": false,      "workspace": {        "gid": "1126509132283071",        "resource_type": "workspace"      },      "team": {        "gid": "1202178854270529",        "resource_type": "team"      },      "start_on": null,      "color": "light-green",      "followers": [        {          "gid": "1202178852626547",          "resource_type": "user"        }      ]    }  }}

Attach File to Task#

Attach a file to a task | key: attachFileToTask

InputNotesExample
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
File
data
/ Required
Notes
File to attach. This should be a reference to a previous step
Example
 
Input
File Name
string
/ Required
Notes
Name of the file to attach
Example
my-image.png
Input
Task ID
string
/ Required
Notes
Provide the unique identifier for the task.
Example
375893453

Output Example Payload#

{  "data": {    "data": {      "gid": "12345",      "resource_type": "attachment",      "name": "Screenshot.png",      "resource_subtype": "asana"    }  }}

Create Portfolio#

Create a new portfolio | key: createPortfolio

InputDefaultNotesExample
Input
Connection
connection
/ Required
Default
 
Notes
 
Example
 
Input
Color
string
/ Required
Default
light-green
Notes
Provide a value for the color of the object.
Example
 
Input
Public
boolean
/ Required
Default
false
Notes
True if the object is public to its team.
Example
 
Input
Members
string
Value List
Default
Notes
For each value, provide the user id of a member. These can either be the string 'me', an email, or the gid of a user.
Example
843750385
Input
Portfolio Name
string
/ Required
Default
Notes
Give a name to the portfolio
Example
My Portfolio
Input
Workspace ID
string
/ Required
Default
Notes
The gid of the workspace
Example
375893453

Output Example Payload#

{  "data": {    "data": {      "gid": "12345",      "resource_type": "portfolio",      "color": "light-green",      "name": "Bug Portfolio",      "created_at": "2012-02-22T02:06:58.147Z",      "created_by": {        "gid": "12345",        "resource_type": "user",        "name": "Greg Sanchez"      },      "current_status_update": {        "gid": "12345",        "resource_type": "status_update",        "resource_subtype": "project_status_update",        "title": "Status Update - Jun 15"      },      "custom_field_settings": [        {          "gid": "12345",          "resource_type": "custom_field_setting",          "custom_field": {            "gid": "12345",            "resource_type": "custom_field",            "created_by": {              "gid": "12345",              "resource_type": "user",              "name": "Greg Sanchez"            },            "currency_code": "EUR",            "custom_label": "gold pieces",            "custom_label_position": "suffix",            "description": "Development team priority",            "display_value": "blue",            "enabled": true,            "enum_options": [              {                "gid": "12345",                "resource_type": "enum_option",                "color": "blue",                "enabled": true,                "name": "Low"              }            ],            "enum_value": {              "gid": "12345",              "resource_type": "enum_option",              "color": "blue",              "enabled": true,              "name": "Low"            },            "format": "custom",            "has_notifications_enabled": true,            "is_global_to_workspace": true,            "multi_enum_values": [              {                "gid": "12345",                "resource_type": "enum_option",                "color": "blue",                "enabled": true,                "name": "Low"              }            ],            "name": "Status",            "number_value": 5.2,            "precision": 2,            "resource_subtype": "text",            "text_value": "Some Value",            "type": "text"          },          "is_important": false,          "parent": {            "gid": "12345",            "resource_type": "project",            "name": "Stuff to buy"          },          "project": {            "gid": "12345",            "resource_type": "project",            "name": "Stuff to buy"          }        }      ],      "due_on": "2019-09-15",      "members": [        {          "gid": "12345",          "resource_type": "user",          "name": "Greg Sanchez"        }      ],      "owner": {        "gid": "12345",        "resource_type": "user",        "name": "Greg Sanchez"      },      "permalink_url": "https://app.asana.com/0/resource/123456789/list",      "public": false,      "start_on": "2019-09-14",      "workspace": {        "gid": "12345",        "resource_type": "workspace",        "name": "My Company Workspace"      }    }  }}

Create Project#

Create a new project inside of an existing team or organization | key: createProjects

InputDefaultNotesExample
Input
Archived
boolean
Default
false
Notes
True if the project is archived, false if not. Archived projects do not show in the UI by default and may be treated differently for queries.
Example
 
Input
Connection
connection
/ Required
Default
 
Notes
 
Example
 
Input
Default View
string
/ Required
Default
list
Notes
The default view of the project.
Example
 
Input
Due On
string
Default
Notes
The date in which the project is due. This field takes a date with YYYY-MM-DD format and should not be used together with due_at.
Example
2019-09-15
Input
Followers
string
Default
Notes
Provide a comma separated string of users.
Example
8570756435,375893453
Input
Public
boolean
/ Required
Default
false
Notes
True if the object is public to its team.
Example
 
Input
Name
string
Default
Notes
Name of the project. This is generally a short sentence fragment that fits on a line in the UI for maximum readability.
Example
Example - Populate customers page with live data
Input
Notes
text
Default
Notes
Free-form textual information associated with the object (ie., its description).
Example
These are some example notes.
Input
Owner ID
string
/ Required
Default
Notes
Provide the unique identifier of the owner of the project.
Example
375893453
Input
Project Color
string
Default
light-green
Notes
The default color for your project
Example
 
Input
Start On
string
Default
Notes
The day on which work for this project begins, or null if the project has no start date. This takes a date with YYYY-MM-DD format
Example
2021-11-14
Input
Team ID
string
/ Required
Default
Notes
The team that this project is shared with. This field only exists for projects in organizations. Including this field if you do not meet those conditions could cause your request to fail.
Example
375893453
Input
Workspace ID
string
Default
Notes
Include this value if you would like this project to be included in a workspace.
Example
375893453

Output Example Payload#

{  "data": {    "data": {      "gid": "1202461772995112",      "resource_type": "project",      "created_at": "2022-06-16T22:53:48.986Z",      "modified_at": "2022-06-16T22:53:48.986Z",      "members": [        {          "gid": "1202178852626547",          "resource_type": "user"        }      ],      "owner": {        "gid": "1202178852626547",        "resource_type": "user"      },      "due_on": null,      "current_status": null,      "public": false,      "name": "My Cool Project",      "notes": "Some notes on my project",      "archived": false,      "workspace": {        "gid": "1126509132283071",        "resource_type": "workspace"      },      "team": {        "gid": "1202178854270529",        "resource_type": "team"      },      "start_on": null,      "color": "light-green",      "followers": [        {          "gid": "1202178852626547",          "resource_type": "user"        }      ],      "html_notes": "<body>Some notes on my project</body>"    }  }}

Create Section#

Create a new section of a project | key: createSection

InputNotesExample
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
Insert After
string
Notes
The ID of the field or section to insert this one insert after
Example
843750385
Input
Insert before
string
Notes
The ID of the field or section to insert this one before
Example
843750385
Input
Project ID
string
/ Required
Notes
Provide the unique identifier of the project.
Example
375893453
Input
Section Name
string
/ Required
Notes
Provide a value for the name of the section
Example
843750385

Output Example Payload#

{  "data": {    "data": {      "gid": "1202465892953048",      "resource_type": "section",      "created_at": "2022-06-17T15:53:48.455Z",      "name": "My Example Section",      "project": {        "gid": "1202178854270532",        "resource_type": "project"      }    }  }}

Create Status Update#

Create a status update from a project, portfolio, or goal | key: createStatusUpdate

InputDefaultNotesExample
Input
Connection
connection
/ Required
Default
 
Notes
 
Example
 
Input
Limit
string
Default
Notes
The maximum number of items you would like returned (between 1 and 100)
Example
20
Input
Offset
string
Default
Notes
An offset token returned from a previous query that had a next_page property
Example
eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9
Input
Project, portfolio, or goal ID
string
/ Required
Default
Notes
The GID for a project, portfolio, or goal
Example
375893453
Input
This represents the current state of the object
string
/ Required
Default
on_track
Notes
 
Example
 
Input
Status Text
string
/ Required
Default
Notes
The text content of the status update.
Example
The project is moving forward according to plan.
Input
Status Title
string
/ Required
Default
Notes
The title of the project status update.
Example
Example Status Update - Jun 15

Output Example Payload#

{  "data": {    "data": {      "gid": "1202466825616154",      "resource_type": "status_update",      "num_hearts": 0,      "num_likes": 0,      "title": "Example project is going well",      "created_at": "2022-06-17T19:09:58.169Z",      "modified_at": "2022-06-17T19:09:58.169Z",      "status_type": "on_track",      "text": "It'll be completed on time!",      "parent": {        "gid": "1202178854270532",        "resource_type": "project",        "name": "Example Project"      },      "resource_subtype": "project_status_update",      "hearted": false,      "hearts": [],      "liked": false,      "likes": [],      "created_by": {        "gid": "1202178852626547",        "resource_type": "user",        "name": "Example User"      },      "html_text": "<body>It'll be completed on time!</body>"    }  }}

Create Tag#

Create a new tag | key: createTag

InputDefaultNotesExample
Input
Connection
connection
/ Required
Default
 
Notes
 
Example
 
Input
Color
string
/ Required
Default
light-green
Notes
Provide a value for the color of the object.
Example
 
Input
Followers List
string
Value List
Default
Notes
For each item, provide the unique identifier of an existing userId.
Example
843750385
Input
Name
string
Default
Notes
Name of the project. This is generally a short sentence fragment that fits on a line in the UI for maximum readability.
Example
Example - Populate customers page with live data
Input
Notes
text
Default
Notes
Free-form textual information associated with the object (ie., its description).
Example
These are some example notes.
Input
Workspace ID
string
/ Required
Default
Notes
The gid of the workspace
Example
375893453

Output Example Payload#

{  "data": {    "data": {      "gid": "1202453507919841",      "resource_type": "tag",      "create_at": "2022-06-15T17:03:26.911Z",      "name": "My Example Tag",      "workspace": {        "gid": 1126509132283071,        "resource_type": "workspace"      },      "color": "light-green",      "followers": []    }  }}

Create Task#

Create a new task inside a workspace or organization | key: createTask

InputNotesExample
Input
Approval Status
string
/ Required
Notes
Provide a string value for the approval status of the task.
Example
Pending
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
Assignee ID
string
Notes
Provide the unique identifier of the assignee.
Example
843750385
Input
Assignee Section ID
string
Notes
Provide the unique identifier of the section to assign the task to. The assignee section is a subdivision of a project that groups tasks together in the assignee's 'My Tasks' list.
Example
843750385
Input
Assignee Status
string
Notes
Provide a string value representing the status the task has in relation to its assignee. This field is deprecated, you can still use it to form requests but it is not recommended for creating new records.
Example
upcoming
Input
Completed By
string
Notes
Provide a string value for the name of the user who completed the task. You can also provide a userId, or email.
Example
John Doe
Input
Due At
string
Notes
Provide an ISO 8601 date string in UTC and should NOT be used together with Due On.
Example
2019-09-15T02:06:58.147Z
Input
Due On
string
Notes
The date in which the project is due. This field takes a date with YYYY-MM-DD format and should not be used together with due_at.
Example
2019-09-15
Input
Followers List
string
Value List
Notes
For each item, provide the unique identifier of an existing userId.
Example
843750385
Input
Completed
string
Notes
True if the task is completed, false if not. Select 'Do not change' to avoid updating this value.
Example
 
Input
Is Liked
string
Notes
This flag will mark the specified task as 'liked' in your Asana account.
Example
 
Input
Name
string
Notes
Name of the project. This is generally a short sentence fragment that fits on a line in the UI for maximum readability.
Example
Example - Populate customers page with live data
Input
Notes
text
Notes
Free-form textual information associated with the object (ie., its description).
Example
These are some example notes.
Input
Parent ID
string
Notes
Provide the unique identifier of the parent element.
Example
843750385
Input
Project List
string
Value List
Notes
For each item, provide the unique identifier of the project.
Example
843750385
Input
Resource Subtype
string
Notes
Provide a string value for the type of object.
Example
task
Input
Start On
string
Notes
The day on which work for this project begins, or null if the project has no start date. This takes a date with YYYY-MM-DD format
Example
2021-11-14
Input
Workspace ID
string
/ Required
Notes
The gid of the workspace
Example
375893453

Output Example Payload#

{  "data": {    "data": {      "gid": "1202461248558215",      "projects": [],      "memberships": [],      "resource_type": "task",      "created_at": "2022-06-16T20:30:21.641Z",      "modified_at": "2022-06-16T20:30:21.932Z",      "name": "My Task Name",      "is_rendered_as_separator": false,      "notes": "Here's my task notes!",      "assignee": {        "gid": "1202178852626547",        "resource_type": "user"      },      "completed": false,      "assignee_status": "inbox",      "completed_at": null,      "due_on": null,      "due_at": null,      "resource_subtype": "default_task",      "start_on": null,      "tags": [],      "workspace": {        "gid": "1126509132283071",        "resource_type": "workspace"      },      "liked": false,      "num_likes": 0,      "followers": [        {          "gid": "1202178852626547",          "resource_type": "user"        }      ],      "html_notes": "<body>Here's my task notes!</body>",      "parent": null,      "likes": []    }  }}

Create Team#

Create a new team | key: createTeam

InputNotesExample
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
Organization or Workspace ID
string
/ Required
Notes
Provide the unique identifier of the organization or workspace
Example
375893453
Input
Description
string
Notes
Provide a string value for the description of the team.
Example
This is an example description
Input
Name
string
/ Required
Notes
Provide a string value for the name of the team.
Example
Engineering Team

Output Example Payload#

{  "data": {    "data": {      "gid": "1202466032099844",      "resource_type": "team",      "name": "My New Team",      "permalink_url": "https://app.asana.com/0/1202466032099844",      "organization": {        "gid": "1126509132283071",        "resource_type": "workspace",        "name": "Prismatic"      }    }  }}

Create Webhook#

Create a webhook to send data from Asana to an instance URL | key: createWebhook

InputNotesExample
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
Webhook URL
string
/ Required
Notes
Reference a flow's URL from the trigger payload
Example
 
Input
Resource ID
string
/ Required
Notes
The GID of a project, portfolio, goal, task, etc - the resource to listen for
Example
375893453

Delete Attachment#

Delete an existing attachment | key: deleteAttachment

InputNotesExample
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
Attachment ID
string
/ Required
Notes
Provide an id for the given attachment
Example
843750385

Output Example Payload#

{  "data": {    "data": {}  }}

Delete Instance Webhooks#

Delete all Asana webhooks that point to a flow in this instance | key: deleteInstanceWebhooks

InputNotesExample
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
Workspace ID
string
/ Required
Notes
The gid of the workspace
Example
375893453

Delete Portfolio#

Delete the information and metadata of a portfolio | key: deletePortfolio

InputNotesExample
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
Portfolio ID
string
/ Required
Notes
Provide the unique identifier of the portfolio.
Example
843750385

Output Example Payload#

{  "data": {    "data": {}  }}

Delete Project#

Delete the information and metadata of a project by Id | key: deleteProjects

InputNotesExample
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
Project ID
string
/ Required
Notes
Provide the unique identifier of the project.
Example
375893453

Output Example Payload#

{  "data": {    "data": {}  }}

Delete Section#

Delete the information and metadata of a section | key: deleteSection

InputNotesExample
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
Section ID
string
/ Required
Notes
The unique identifier of the section
Example
843750385

Output Example Payload#

{  "data": {    "data": {}  }}

Delete Status#

Delete a status update | key: deleteStatus

InputNotesExample
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
Status ID
string
/ Required
Notes
The gid of the status update
Example
375893453

Output Example Payload#

{  "data": {    "data": {}  }}

Delete Tag#

Delete the information and metadata of the given tag | key: deleteTag

InputNotesExample
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
Limit
string
Notes
The maximum number of items you would like returned (between 1 and 100)
Example
20
Input
Offset
string
Notes
An offset token returned from a previous query that had a next_page property
Example
eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9
Input
Tag ID
string
/ Required
Notes
The unique identifier of the tag
Example
843750385

Output Example Payload#

{  "data": {    "data": {}  }}

Delete Task#

Delete the information and metadata of an existing task | key: deleteTask

InputNotesExample
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
Task ID
string
/ Required
Notes
Provide the unique identifier for the task.
Example
375893453

Output Example Payload#

{  "data": {    "data": {}  }}

Delete Webhook#

Delete a webhook by ID | key: deleteWebhook

InputNotesExample
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
Webhook ID
string
/ Required
Notes
The gid of the workspace
Example
375893453

Output Example Payload#

{  "data": {}}

Find Tag by Name#

Find a tag of a given name within a workspace | key: findTagByName

InputNotesExample
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
Tag Name
string
/ Required
Notes
Note: if multiple tags share a name, only one tag will be returned.
Example
 
Input
Workspace ID
string
/ Required
Notes
The gid of the workspace
Example
375893453

Output Example Payload#

{  "data": {    "gid": "1202467057873527",    "color": "dark-green",    "created_at": "2022-06-17T20:28:26.601Z",    "name": "My Example Tag Name",    "resource_type": "tag"  }}

Find Team by Name#

Find a team of a given name within a workspace | key: findTeamByName

InputNotesExample
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
Team Name
string
/ Required
Notes
Note: if multiple teams share a name, only one team will be returned.
Example
 
Input
Workspace ID
string
/ Required
Notes
The gid of the workspace
Example
375893453

Output Example Payload#

{  "data": {    "gid": "1126509132283071",    "name": "Example Team",    "resource_type": "team"  }}

Find User by Name or Email#

Find a user with the given name or email address in your workspace | key: findUserByNameOrEmail

InputNotesExample
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
User's Email
string
Notes
Note: if multiple users share an email address, only one user will be returned.
Example
john.doe@example.com
Input
User's Full Name
string
Notes
Note: if multiple users share a name, only one user will be returned.
Example
John Doe
Input
Workspace ID
string
/ Required
Notes
The gid of the workspace
Example
375893453

Output Example Payload#

{  "data": {    "gid": "1126508793140155",    "email": "user@example.com",    "name": "Example User",    "resource_type": "user",    "workspaces": [      {        "gid": "1126509132283071",        "name": "Example Workspace",        "resource_type": "workspace"      }    ]  }}

Find Workspace by Name#

Find a workspace of a given name | key: findWorkspaceByName

InputNotes
Input
Connection
connection
/ Required
Notes
 
Input
Workspace Name
string
/ Required
Notes
 

Output Example Payload#

{  "data": {    "gid": "1126509132283071",    "name": "Example Workspace",    "resource_type": "workspace"  }}

Get Attachments#

Get the information and metadata of an attachment | key: getAttachment

InputNotesExample
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
Attachment ID
string
/ Required
Notes
Provide an id for the given attachment
Example
843750385

Output Example Payload#

{  "data": {    "data": {      "gid": "12345",      "resource_type": "attachment",      "name": "Screenshot.png",      "resource_subtype": "dropbox",      "created_at": "2012-02-22T02:06:58.147Z",      "download_url": "https://s3.amazonaws.com/assets/123/Screenshot.png",      "host": "dropbox",      "parent": {        "gid": "12345",        "resource_type": "task",        "name": "Bug Task",        "resource_subtype": "default_task"      },      "permanent_url": "https://s3.amazonaws.com/assets/123/Screenshot.png",      "view_url": "https://www.dropbox.com/s/123/Screenshot.png"    }  }}

Get Current User#

Get information about the currently authenticated user | key: getCurrentUser

InputNotes
Input
Connection
connection
/ Required
Notes
 

Output Example Payload#

{  "data": {    "data": {      "gid": "1126508793140155",      "email": "user@example.com",      "name": "Example User",      "photo": {        "image_21x21": "https://s3.amazonaws.com/profile_photos/1126508793140155.1126509132283075.joZwntHYCrotR7QnI82A_21x21.png",        "image_27x27": "https://s3.amazonaws.com/profile_photos/1126508793140155.1126509132283075.joZwntHYCrotR7QnI82A_27x27.png",        "image_36x36": "https://s3.amazonaws.com/profile_photos/1126508793140155.1126509132283075.joZwntHYCrotR7QnI82A_36x36.png",        "image_60x60": "https://s3.amazonaws.com/profile_photos/1126508793140155.1126509132283075.joZwntHYCrotR7QnI82A_60x60.png",        "image_128x128": "https://s3.amazonaws.com/profile_photos/1126508793140155.1126509132283075.joZwntHYCrotR7QnI82A_128x128.png"      },      "resource_type": "user",      "workspaces": [        {          "gid": "1126509132283071",          "name": "Example Workspace",          "resource_type": "workspace"        }      ]    }  }}

Get Custom Field#

Get the information and metadata of a custom field | key: getCustomField

InputNotesExample
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
Field ID
string
/ Required
Notes
The unique identifier of the field
Example
843750385

Output Example Payload#

{  "data": {    "data": {      "gid": "1202467472002610",      "enum_options": [        {          "gid": "1202467472002611",          "color": "red",          "enabled": true,          "name": "High",          "resource_type": "enum_option"        },        {          "gid": "1202467472002612",          "color": "orange",          "enabled": true,          "name": "Medium",          "resource_type": "enum_option"        },        {          "gid": "1202467472002613",          "color": "yellow-orange",          "enabled": true,          "name": "Low",          "resource_type": "enum_option"        }      ],      "name": "Priority",      "description": "Asana-created. Track the priority of each task.",      "resource_subtype": "enum",      "resource_type": "custom_field"    }  }}

Get Portfolio#

Get the information and metadata of a portfolio | key: getPortfolio

InputNotesExample
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
Portfolio ID
string
/ Required
Notes
Provide the unique identifier of the portfolio.
Example
843750385

Output Example Payload#

{  "data": {    "data": {      "gid": "12345",      "resource_type": "portfolio",      "color": "light-green",      "name": "Bug Portfolio",      "created_at": "2012-02-22T02:06:58.147Z",      "created_by": {        "gid": "12345",        "resource_type": "user",        "name": "Greg Sanchez"      },      "current_status_update": {        "gid": "12345",        "resource_type": "status_update",        "resource_subtype": "project_status_update",        "title": "Status Update - Jun 15"      },      "custom_field_settings": [        {          "gid": "12345",          "resource_type": "custom_field_setting",          "custom_field": {            "gid": "12345",            "resource_type": "custom_field",            "created_by": {              "gid": "12345",              "resource_type": "user",              "name": "Greg Sanchez"            },            "currency_code": "EUR",            "custom_label": "gold pieces",            "custom_label_position": "suffix",            "description": "Development team priority",            "display_value": "blue",            "enabled": true,            "enum_options": [              {                "gid": "12345",                "resource_type": "enum_option",                "color": "blue",                "enabled": true,                "name": "Low"              }            ],            "enum_value": {              "gid": "12345",              "resource_type": "enum_option",              "color": "blue",              "enabled": true,              "name": "Low"            },            "format": "custom",            "has_notifications_enabled": true,            "is_global_to_workspace": true,            "multi_enum_values": [              {                "gid": "12345",                "resource_type": "enum_option",                "color": "blue",                "enabled": true,                "name": "Low"              }            ],            "name": "Status",            "number_value": 5.2,            "precision": 2,            "resource_subtype": "text",            "text_value": "Some Value",            "type": "text"          },          "is_important": false,          "parent": {            "gid": "12345",            "resource_type": "project",            "name": "Stuff to buy"          },          "project": {            "gid": "12345",            "resource_type": "project",            "name": "Stuff to buy"          }        }      ],      "due_on": "2019-09-15",      "members": [        {          "gid": "12345",          "resource_type": "user",          "name": "Greg Sanchez"        }      ],      "owner": {        "gid": "12345",        "resource_type": "user",        "name": "Greg Sanchez"      },      "permalink_url": "https://app.asana.com/0/resource/123456789/list",      "public": false,      "start_on": "2019-09-14",      "workspace": {        "gid": "12345",        "resource_type": "workspace",        "name": "My Company Workspace"      }    }  }}

Get Project#

Get the information and metadata of a project by Id | key: getProject

InputNotesExample
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
Project ID
string
/ Required
Notes
Provide the unique identifier of the project.
Example
375893453

Output Example Payload#

{  "data": {    "data": {      "gid": "1202461773653662",      "archived": false,      "color": "light-green",      "created_at": "2022-06-16T22:55:11.208Z",      "current_status": null,      "custom_fields": [],      "due_on": null,      "followers": [        {          "gid": "1202178852626547",          "resource_type": "user"        }      ],      "html_notes": "<body>My new project notes</body>",      "members": [        {          "gid": "1202178852626547",          "resource_type": "user"        }      ],      "modified_at": "2022-06-16T22:55:13.275Z",      "name": "My new project name",      "notes": "My new project notes",      "owner": {        "gid": "1202178852626547",        "resource_type": "user"      },      "public": true,      "resource_type": "project",      "start_on": null,      "team": {        "gid": "1202178854270529",        "resource_type": "team"      },      "workspace": {        "gid": "1126509132283071",        "resource_type": "workspace"      }    }  }}

Get Section#

Get the information and metadata of a section | key: getSection

InputNotesExample
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
Section ID
string
/ Required
Notes
The unique identifier of the section
Example
843750385

Output Example Payload#

{  "data": {    "data": {      "gid": "1202178854270533",      "created_at": "2022-04-25T19:28:56.749Z",      "name": "Discussion topics",      "project": {        "gid": "1202178854270532",        "name": "My Example Project",        "resource_type": "project"      },      "resource_type": "section"    }  }}

Get Status Update#

Get a status update | key: getStatusUpdate

InputNotesExample
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
Status ID
string
/ Required
Notes
The gid of the status update
Example
375893453

Output Example Payload#

{  "data": {    "data": {      "gid": "1202466832682204",      "created_at": "2022-06-17T19:14:25.512Z",      "created_by": {        "gid": "1202178852626547",        "name": "Example User",        "resource_type": "user"      },      "modified_at": "2022-06-17T19:14:26.506Z",      "resource_type": "status_update",      "resource_subtype": "project_status_update",      "status_type": "on_track",      "text": "It'll be completed on time!",      "title": "Example project is going well",      "parent": {        "gid": "1202178854270532",        "name": "Example Project",        "resource_type": "project"      }    }  }}

Get Status Updates from Object#

Get status updates from a project, portfolio, or goal | key: getStatusesForObject

InputNotesExample
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
Limit
string
Notes
The maximum number of items you would like returned (between 1 and 100)
Example
20
Input
Offset
string
Notes
An offset token returned from a previous query that had a next_page property
Example
eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9
Input
Project, portfolio, or goal ID
string
/ Required
Notes
The GID for a project, portfolio, or goal
Example
375893453

Output Example Payload#

{  "data": {    "data": [      {        "gid": "1202466843571433",        "created_at": "2022-06-17T19:22:53.380Z",        "resource_type": "status_update",        "resource_subtype": "project_status_update",        "status_type": "at_risk",        "text": "We accidentally force-pushed over our repo!",        "title": "It's going terribly!",        "parent": {          "gid": "1202178854270532",          "resource_type": "project"        }      },      {        "gid": "1202466947841625",        "created_at": "2022-06-17T19:17:33.744Z",        "resource_type": "status_update",        "resource_subtype": "project_status_update",        "status_type": "on_track",        "text": "It'll be completed on time!",        "title": "Example project is going well",        "parent": {          "gid": "1202178854270532",          "resource_type": "project"        }      }    ]  }}

Get Tag#

Get the information and metadata of the given tag | key: getTag

InputNotesExample
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
Tag ID
string
/ Required
Notes
The unique identifier of the tag
Example
843750385

Output Example Payload#

{  "data": {    "data": {      "gid": "1202461566347259",      "color": "light-green",      "created_at": "2022-06-16T21:44:38.673Z",      "followers": [],      "name": "My Example Tag",      "notes": "My Notes",      "resource_type": "tag",      "workspace": {        "gid": "1126509132283071",        "resource_type": "workspace"      }    }  }}

Get Task#

Get the information and metadata of a task | key: getTask

InputNotesExample
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
Task ID
string
/ Required
Notes
Provide the unique identifier for the task.
Example
375893453

Output Example Payload#

{  "data": {    "data": {      "guid": "75834703724",      "projects": "",      "resource_type": "task",      "name": "MyTask",      "notes": "These are my example task notes!",      "completed": false,      "resource_subtype": "default_task",      "tags": "",      "workspace": {        "guid": "867452364563",        "resource_type": "workspace",        "name": "Example Workspace"      },      "custom_fields": {},      "assignee": {        "guid": "32493284234",        "name": "Example Assignee",        "resource_type": "user"      },      "parent": null,      "assignee_status": "inbox",      "hearted": false    }  }}

Get Team#

Get the information and metadata of a team | key: getTeam

InputNotesExample
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
Team ID
string
/ Required
Notes
Provide the unique identifier of the team.
Example
843750385

Output Example Payload#

{  "data": {    "data": {      "gid": "1126509132283073",      "name": "Example Team",      "organization": {        "gid": "1126509132283071",        "name": "Example Org",        "resource_type": "workspace"      },      "permalink_url": "https://app.asana.com/0/1126509132283073",      "resource_type": "team"    }  }}

Get User#

Get the information and metadata of a user | key: getUsers

InputNotesExample
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
User ID
string
/ Required
Notes
The global ID of a user
Example
375893453

Output Example Payload#

{  "data": {    "data": {      "gid": "1126508793140155",      "email": "user@example.com",      "name": "Example User",      "photo": {        "image_21x21": "https://s3.amazonaws.com/profile_photos/1126508793140155.1126509132283075.joZwntHYCrotR7QnI82A_21x21.png",        "image_27x27": "https://s3.amazonaws.com/profile_photos/1126508793140155.1126509132283075.joZwntHYCrotR7QnI82A_27x27.png",        "image_36x36": "https://s3.amazonaws.com/profile_photos/1126508793140155.1126509132283075.joZwntHYCrotR7QnI82A_36x36.png",        "image_60x60": "https://s3.amazonaws.com/profile_photos/1126508793140155.1126509132283075.joZwntHYCrotR7QnI82A_60x60.png",        "image_128x128": "https://s3.amazonaws.com/profile_photos/1126508793140155.1126509132283075.joZwntHYCrotR7QnI82A_128x128.png"      },      "resource_type": "user",      "workspaces": [        {          "gid": "1126509132283071",          "name": "Example Workspace",          "resource_type": "workspace"        }      ]    }  }}

Get Workspace#

Get the information and metadata of the given Workspace | key: getWorkspace

InputNotesExample
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
Workspace ID
string
/ Required
Notes
The gid of the workspace
Example
375893453

Output Example Payload#

{  "data": {    "data": {      "gid": "1126509132283071",      "email_domains": [        "example.com"      ],      "is_organization": true,      "name": "Example Workspace",      "resource_type": "workspace"    }  }}

List Custom Fields#

List all custom fields in a workspace | key: listCustomFields

InputNotesExample
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
Limit
string
Notes
The maximum number of items you would like returned (between 1 and 100)
Example
20
Input
Offset
string
Notes
An offset token returned from a previous query that had a next_page property
Example
eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9
Input
Workspace ID
string
/ Required
Notes
The gid of the workspace
Example
375893453

Output Example Payload#

{  "data": {    "data": [      {        "gid": "1202467472002610",        "enum_options": [          {            "gid": "1202467472002611",            "color": "red",            "enabled": true,            "name": "High",            "resource_type": "enum_option"          },          {            "gid": "1202467472002612",            "color": "orange",            "enabled": true,            "name": "Medium",            "resource_type": "enum_option"          },          {            "gid": "1202467472002613",            "color": "yellow-orange",            "enabled": true,            "name": "Low",            "resource_type": "enum_option"          }        ],        "name": "Priority",        "description": "Asana-created. Track the priority of each task.",        "resource_subtype": "enum",        "resource_type": "custom_field"      },      {        "gid": "1202476274909067",        "enum_options": [          {            "gid": "1202476274909068",            "color": "green",            "enabled": true,            "name": "My First Option",            "resource_type": "enum_option"          },          {            "gid": "1202476274909069",            "color": "red",            "enabled": true,            "name": "My Second Option",            "resource_type": "enum_option"          },          {            "gid": "1202476274909070",            "color": "orange",            "enabled": true,            "name": "My Third Option",            "resource_type": "enum_option"          }        ],        "name": "Do you want these things?",        "description": "",        "resource_subtype": "multi_enum",        "resource_type": "custom_field"      },      {        "gid": "1202476390317834",        "name": "Milestone",        "description": "",        "resource_subtype": "text",        "resource_type": "custom_field"      },      {        "gid": "1202476390885516",        "name": "Percent Complete",        "description": "",        "precision": 0,        "resource_subtype": "number",        "resource_type": "custom_field"      }    ]  }}

List Portfolio Items#

List all items in a given portfolio | key: listPortfolioItems

InputNotesExample
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
Limit
string
Notes
The maximum number of items you would like returned (between 1 and 100)
Example
20
Input
Offset
string
Notes
An offset token returned from a previous query that had a next_page property
Example
eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9
Input
Portfolio ID
string
/ Required
Notes
Provide the unique identifier of the portfolio.
Example
843750385

Output Example Payload#

{  "data": {    "data": [      {        "gid": "12345",        "resource_type": "project",        "name": "Stuff to buy"      }    ]  }}

List Portfolios#

List portfolios that the authenticated user owns | key: listPortfolios

InputNotesExample
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
Limit
string
Notes
The maximum number of items you would like returned (between 1 and 100)
Example
20
Input
Offset
string
Notes
An offset token returned from a previous query that had a next_page property
Example
eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9
Input
Workspace ID
string
/ Required
Notes
The gid of the workspace
Example
375893453

Output Example Payload#

{  "data": {    "data": [      {        "gid": "12345",        "resource_type": "portfolio",        "name": "Example Portfolio"      }    ]  }}

List Projects#

Return a list of all projects connected to your account | key: listProjects

InputNotesExample
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
Limit
string
Notes
The maximum number of items you would like returned (between 1 and 100)
Example
20
Input
Offset
string
Notes
An offset token returned from a previous query that had a next_page property
Example
eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9
Input
Workspace ID
string
Notes
The gid of the workspace
Example
375893453

Output Example Payload#

{  "data": {    "data": [      {        "gid": "1202178854270532",        "archived": false,        "color": "light-pink",        "created_at": "2022-04-25T19:28:55.557Z",        "current_status": null,        "custom_fields": [],        "due_on": "2022-05-25",        "followers": [          {            "gid": "1202178852626547",            "resource_type": "user"          }        ],        "html_notes": "<body>Asana helps you plan your 1:1s in advance, stay focused during the conversation, and track notes and action items.</body>",        "members": [          {            "gid": "1202178852626547",            "resource_type": "user"          }        ],        "modified_at": "2022-06-15T21:21:40.641Z",        "name": "[Sample] [Teammate] / Prismatic 1:1",        "notes": "Asana helps you plan your 1:1s in advance, stay focused during the conversation, and track notes and action items.",        "owner": {          "gid": "1202178852626547",          "resource_type": "user"        },        "public": false,        "resource_type": "project",        "start_on": "2022-04-25",        "team": {          "gid": "1202178854270529",          "resource_type": "team"        },        "workspace": {          "gid": "1126509132283071",          "resource_type": "workspace"        }      }    ]  }}

List Sections#

List all sections of the given project | key: listSections

InputNotesExample
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
Limit
string
Notes
The maximum number of items you would like returned (between 1 and 100)
Example
20
Input
Offset
string
Notes
An offset token returned from a previous query that had a next_page property
Example
eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9
Input
Project ID
string
/ Required
Notes
Provide the unique identifier of the project.
Example
375893453

Output Example Payload#

{  "data": {    "data": [      {        "gid": "1202178854270533",        "created_at": "2022-04-25T19:28:56.749Z",        "name": "Discussion topics",        "project": {          "gid": "1202178854270532",          "resource_type": "project"        },        "resource_type": "section"      },      {        "gid": "1202178854270541",        "created_at": "2022-04-25T19:28:59.950Z",        "name": "FYIs",        "project": {          "gid": "1202178854270532",          "resource_type": "project"        },        "resource_type": "section"      }    ]  }}

List Subtasks#

Return a list of all subtasks in a given task | key: listSubtasks

InputNotesExample
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
Limit
string
Notes
The maximum number of items you would like returned (between 1 and 100)
Example
20
Input
Offset
string
Notes
An offset token returned from a previous query that had a next_page property
Example
eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9
Input
Task ID
string
/ Required
Notes
Provide the unique identifier for the task.
Example
375893453

Output Example Payload#

{  "data": {    "data": [      {        "gid": "1202461528125029",        "assignee": {          "gid": "1202178852626547",          "resource_type": "user"        },        "assignee_status": "inbox",        "completed": false,        "completed_at": null,        "created_at": "2022-06-16T21:31:46.425Z",        "due_at": null,        "due_on": null,        "followers": [          {            "gid": "1202178852626547",            "resource_type": "user"          }        ],        "html_notes": "<body>Here's my task notes!</body>",        "is_rendered_as_separator": false,        "liked": false,        "likes": [],        "memberships": [],        "modified_at": "2022-06-16T21:31:54.809Z",        "name": "My new task name",        "notes": "Here's my task notes!",        "num_likes": 0,        "num_subtasks": 0,        "parent": {          "gid": "1202178854270531",          "resource_type": "task"        },        "projects": [],        "resource_type": "task",        "start_on": null,        "tags": [          {            "gid": "1202453664069905",            "resource_type": "tag"          }        ],        "resource_subtype": "default_task",        "workspace": {          "gid": "1126509132283071",          "resource_type": "workspace"        }      }    ]  }}

List Tags#

List all tags in your account | key: listTags

InputNotesExample
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
Limit
string
Notes
The maximum number of items you would like returned (between 1 and 100)
Example
20
Input
Offset
string
Notes
An offset token returned from a previous query that had a next_page property
Example
eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9
Input
Workspace ID
string
/ Required
Notes
The gid of the workspace
Example
375893453

Output Example Payload#

{  "data": {    "data": [      {        "gid": "1202453507919841",        "color": "light-green",        "created_at": "2022-06-15T17:03:26.911Z",        "followers": [],        "name": "My example tag",        "resource_type": "tag",        "workspace": {          "gid": "1126509132283071",          "resource_type": "workspace"        }      }    ]  }}

List Tags In Task#

List all tags in a given task | key: listTagsInTask

InputNotesExample
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
Limit
string
Notes
The maximum number of items you would like returned (between 1 and 100)
Example
20
Input
Offset
string
Notes
An offset token returned from a previous query that had a next_page property
Example
eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9
Input
Task ID
string
/ Required
Notes
Provide the unique identifier for the task.
Example
375893453

Output Example Payload#

{  "data": {    "data": [      {        "gid": "1202453664069905",        "color": "light-green",        "created_at": "2022-06-15T17:32:21.828Z",        "followers": [],        "name": "My example tag",        "resource_type": "tag",        "workspace": {          "gid": "1126509132283071",          "resource_type": "workspace"        }      }    ]  }}

List task attachments#

List all attachments in a given task | key: listAttachments

InputNotesExample
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
Limit
string
Notes
The maximum number of items you would like returned (between 1 and 100)
Example
20
Input
Offset
string
Notes
An offset token returned from a previous query that had a next_page property
Example
eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9
Input
Task ID
string
/ Required
Notes
Provide the unique identifier for the task.
Example
375893453

Output Example Payload#

{  "data": {    "data": [      {        "gid": "12345",        "resource_type": "attachment",        "name": "Screenshot.png",        "resource_subtype": "dropbox"      }    ]  }}

List Tasks#

Return a list of tasks | key: listTasks

InputNotesExample
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
Assignee ID
string
Notes
Provide the unique identifier of the assignee.
Example
843750385
Input
Limit
string
Notes
The maximum number of items you would like returned (between 1 and 100)
Example
20
Input
Offset
string
Notes
An offset token returned from a previous query that had a next_page property
Example
eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9
Input
Project ID
string
Notes
Provide the unique identifier of the project.
Example
375893453
Input
Workspace ID
string
Notes
The gid of the workspace
Example
375893453

You must specify a project, or a combination of an assignee and workspace.

Output Example Payload#

{  "data": {    "data": [      {        "gid": "1202178854270531",        "assignee": {          "gid": "1202178852626547",          "resource_type": "user"        },        "assignee_status": "today",        "completed": false,        "completed_at": null,        "created_at": "2022-04-25T19:28:54.408Z",        "due_at": null,        "due_on": "2022-05-02",        "followers": [          {            "gid": "1202178852626547",            "resource_type": "user"          }        ],        "html_notes": "<body>We’ve collected a set of guides, tips, and tutorials to help you learn about Asana. Check it out:<ul><li><a href=\"https://asana.com/guide\">https://asana.com/guide</a></li></ul></body>",        "is_rendered_as_separator": false,        "liked": false,        "likes": [],        "memberships": [          {}        ],        "modified_at": "2022-06-15T21:21:41.151Z",        "name": "Learn how Asana works",        "notes": "We’ve collected a set of guides, tips, and tutorials to help you learn about Asana. Check it out: https://asana.com/guide\n",        "num_likes": 0,        "num_subtasks": 0,        "parent": null,        "projects": [          {            "gid": "1202178854270532",            "resource_type": "project"          }        ],        "resource_type": "task",        "start_on": null,        "tags": [          {            "gid": "1202453664069905",            "resource_type": "tag"          },          {            "gid": "1202454369674628",            "resource_type": "tag"          },          {            "gid": "1202454863218026",            "resource_type": "tag"          }        ],        "resource_subtype": "default_task",        "workspace": {          "gid": "1126509132283071",          "resource_type": "workspace"        }      }    ]  }}

List Teams#

List all teams in the given workspace | key: listTeams

InputNotesExample
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
Workspace ID
string
/ Required
Notes
The gid of the workspace
Example
375893453

Output Example Payload#

{  "data": {    "data": [      {        "gid": "1126509132283073",        "name": "Founders",        "resource_type": "team"      },      {        "gid": "1201132129713512",        "name": "Design",        "resource_type": "team"      },      {        "gid": "1201340876723312",        "name": "Engineering",        "resource_type": "team"      }    ]  }}

List Users#

List all users in your account | key: listUsers

InputNotesExample
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
Limit
string
Notes
The maximum number of items you would like returned (between 1 and 100)
Example
20
Input
Offset
string
Notes
An offset token returned from a previous query that had a next_page property
Example
eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9
Input
Workspace ID
string
Notes
Optionally filter by workspace ID
Example
375893453

Output Example Payload#

{  "data": {    "data": [      {        "gid": "1126508793140155",        "name": "Example User 1",        "resource_type": "user",        "email": "user-1@example.com",        "workspaces": [          {            "gid": "1126509132283071",            "resource_type": "workspace"          }        ]      },      {        "gid": "1126508793140156",        "name": "Example User2 ",        "resource_type": "user",        "email": "user-2@example.com",        "workspaces": [          {            "gid": "1126509132283071",            "resource_type": "workspace"          }        ]      }    ]  }}

List Workspace Webhooks#

List all webhooks configured in Asana, including those for other integrations | key: listWebhooks

InputDefaultNotesExample
Input
Connection
connection
/ Required
Default
 
Notes
 
Example
 
Input
Limit
string
Default
Notes
The maximum number of items you would like returned (between 1 and 100)
Example
20
Input
Offset
string
Default
Notes
An offset token returned from a previous query that had a next_page property
Example
eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9
Input
Show only instance webhooks
boolean
Default
true
Notes
Show only webhooks that point to this instance
Example
 
Input
Workspace ID
string
/ Required
Default
Notes
The gid of the workspace
Example
375893453

Output Example Payload#

{  "data": [    {      "gid": "1202700984385446",      "active": true,      "resource": {        "gid": "1202467472002605",        "name": "Brand redesign campaign",        "resource_type": "project"      },      "resource_type": "webhook",      "target": "https://hooks.prismatic.io/trigger/EXAMPLE"    }  ]}

List Workspaces#

List of all workspaces connected to your account | key: listWorkspaces

InputNotesExample
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
Limit
string
Notes
The maximum number of items you would like returned (between 1 and 100)
Example
20
Input
Offset
string
Notes
An offset token returned from a previous query that had a next_page property
Example
eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9

Output Example Payload#

{  "data": {    "data": [      {        "gid": "1126509132283071",        "name": "Example Workspace 1",        "resource_type": "workspace"      },      {        "gid": "1126509132283072",        "name": "Example Workspace 2",        "resource_type": "workspace"      }    ]  }}

Remove Custom Field From Portfolio#

Remove a custom field from an existing portfolio | key: removeCustomFieldFromPortfolio

InputNotesExample
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
Field ID
string
/ Required
Notes
The unique identifier of the field
Example
843750385
Input
Portfolio ID
string
/ Required
Notes
Provide the unique identifier of the portfolio.
Example
843750385

Output Example Payload#

{  "data": {    "data": {}  }}

Remove Custom Field From Project#

Remove an existing Custom Field from an existing Project | key: removeCustomFieldFromProject

InputNotesExample
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
Field ID
string
/ Required
Notes
The unique identifier of the field
Example
843750385
Input
Project ID
string
/ Required
Notes
Provide the unique identifier of the project.
Example
375893453

Output Example Payload#

{  "data": {    "data": {}  }}

Remove Followers From Task#

Remove followers from the given task | key: removeFollowersFromTask

InputNotesExample
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
Followers List
string
Value List
Notes
For each item, provide the unique identifier of an existing userId.
Example
843750385
Input
Task ID
string
/ Required
Notes
Provide the unique identifier for the task.
Example
375893453

Output Example Payload#

{  "data": {    "data": {      "gid": "1202461530991735",      "resource_type": "task",      "created_at": "2022-06-16T21:33:52.572Z",      "name": "My new task name",      "workspace": {        "gid": "1126509132283071",        "resource_type": "workspace"      },      "followers": []    }  }}

Remove Portfolio Item#

Remove an existing item from the given portfolio | key: removePortfolioItem

InputNotesExample
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
Item ID
string
/ Required
Notes
Provide the unique identifier of the Item.
Example
843750385
Input
Portfolio ID
string
/ Required
Notes
Provide the unique identifier of the portfolio.
Example
843750385

Output Example Payload#

{  "data": {    "data": {}  }}

Remove Tag From Task#

Remove a tag from the given task | key: removeTagFromTask

InputNotesExample
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
Tag ID
string
/ Required
Notes
The unique identifier of the tag
Example
843750385
Input
Task ID
string
/ Required
Notes
Provide the unique identifier for the task.
Example
375893453

Output Example Payload#

{  "data": {    "data": {}  }}

Remove Users From Portfolio#

Remove existing users from the given portfolio | key: removeUserFromPortfolio

InputNotesExample
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
Members
string
Value List
Notes
For each value, provide the user id of a member. These can either be the string 'me', an email, or the gid of a user.
Example
843750385
Input
Portfolio ID
string
/ Required
Notes
Provide the unique identifier of the portfolio.
Example
843750385

Output Example Payload#

{  "data": {    "data": {      "gid": "1202476367473313",      "resource_type": "portfolio",      "created_at": "2022-06-20T18:18:47.435Z",      "created_by": {        "gid": "1202467472237333",        "resource_type": "user"      },      "name": "Example Portfolio",      "members": [        {          "gid": "1202467472237333",          "resource_type": "user"        },        {          "gid": "1202467584678838",          "resource_type": "user"        }      ],      "custom_field_settings": [],      "workspace": {        "gid": "1202467471973207",        "resource_type": "workspace"      },      "color": "light-green"    }  }}

Update Portfolio#

Update the information and metadata of the given portfolio | key: updatePortfolio

InputDefaultNotesExample
Input
Connection
connection
/ Required
Default
 
Notes
 
Example
 
Input
Color
string
Default
light-green
Notes
Provide a value for the color of the object.
Example
 
Input
Public
boolean
/ Required
Default
false
Notes
True if the object is public to its team.
Example
 
Input
Portfolio ID
string
/ Required
Default
Notes
Provide the unique identifier of the portfolio.
Example
843750385
Input
Portfolio Name
string
Default
Notes
Give a name to the portfolio
Example
My Portfolio
Input
Workspace ID
string
Default
Notes
The gid of the workspace
Example
375893453

Output Example Payload#

{  "data": {    "data": {      "gid": "12345",      "resource_type": "portfolio",      "color": "light-green",      "name": "Bug Portfolio",      "created_at": "2012-02-22T02:06:58.147Z",      "created_by": {        "gid": "12345",        "resource_type": "user",        "name": "Greg Sanchez"      },      "current_status_update": {        "gid": "12345",        "resource_type": "status_update",        "resource_subtype": "project_status_update",        "title": "Status Update - Jun 15"      },      "custom_field_settings": [        {          "gid": "12345",          "resource_type": "custom_field_setting",          "custom_field": {            "gid": "12345",            "resource_type": "custom_field",            "created_by": {              "gid": "12345",              "resource_type": "user",              "name": "Greg Sanchez"            },            "currency_code": "EUR",            "custom_label": "gold pieces",            "custom_label_position": "suffix",            "description": "Development team priority",            "display_value": "blue",            "enabled": true,            "enum_options": [              {                "gid": "12345",                "resource_type": "enum_option",                "color": "blue",                "enabled": true,                "name": "Low"              }            ],            "enum_value": {              "gid": "12345",              "resource_type": "enum_option",              "color": "blue",              "enabled": true,              "name": "Low"            },            "format": "custom",            "has_notifications_enabled": true,            "is_global_to_workspace": true,            "multi_enum_values": [              {                "gid": "12345",                "resource_type": "enum_option",                "color": "blue",                "enabled": true,                "name": "Low"              }            ],            "name": "Status",            "number_value": 5.2,            "precision": 2,            "resource_subtype": "text",            "text_value": "Some Value",            "type": "text"          },          "is_important": false,          "parent": {            "gid": "12345",            "resource_type": "project",            "name": "Stuff to buy"          },          "project": {            "gid": "12345",            "resource_type": "project",            "name": "Stuff to buy"          }        }      ],      "due_on": "2019-09-15",      "members": [        {          "gid": "12345",          "resource_type": "user",          "name": "Greg Sanchez"        }      ],      "owner": {        "gid": "12345",        "resource_type": "user",        "name": "Greg Sanchez"      },      "permalink_url": "https://app.asana.com/0/resource/123456789/list",      "public": false,      "start_on": "2019-09-14",      "workspace": {        "gid": "12345",        "resource_type": "workspace",        "name": "My Company Workspace"      }    }  }}

Update Project#

Update the information and metadata of a project | key: updateProject

InputDefaultNotesExample
Input
Archived
boolean
Default
false
Notes
True if the project is archived, false if not. Archived projects do not show in the UI by default and may be treated differently for queries.
Example
 
Input
Connection
connection
/ Required
Default
 
Notes
 
Example
 
Input
Default View
string
Default
Notes
The default view of the project.
Example
 
Input
Due On
string
Default
Notes
The date in which the project is due. This field takes a date with YYYY-MM-DD format and should not be used together with due_at.
Example
2019-09-15
Input
Followers
string
Default
Notes
Provide a comma separated string of users.
Example
8570756435,375893453
Input
Public
boolean
/ Required
Default
false
Notes
True if the object is public to its team.
Example
 
Input
Name
string
Default
Notes
Name of the project. This is generally a short sentence fragment that fits on a line in the UI for maximum readability.
Example
Example - Populate customers page with live data
Input
Notes
text
Default
Notes
Free-form textual information associated with the object (ie., its description).
Example
These are some example notes.
Input
Owner ID
string
Default
Notes
Provide the unique identifier of the owner of the project.
Example
375893453
Input
Project Color
string
Default
light-green
Notes
The default color for your project
Example
 
Input
Project ID
string
/ Required
Default
Notes
Provide the unique identifier of the project.
Example
375893453
Input
Start On
string
Default
Notes
The day on which work for this project begins, or null if the project has no start date. This takes a date with YYYY-MM-DD format
Example
2021-11-14
Input
Team ID
string
Default
Notes
The team that this project is shared with. This field only exists for projects in organizations. Including this field if you do not meet those conditions could cause your request to fail.
Example
375893453

Output Example Payload#

{  "data": {    "data": {      "gid": "1202461680419124",      "resource_type": "project",      "created_at": "2022-06-16T22:39:52.270Z",      "modified_at": "2022-06-16T22:39:54.373Z",      "due_date": null,      "due_on": null,      "current_status_update": null,      "current_status": null,      "public": true,      "name": "My new project name",      "notes": "My new project notes\n",      "archived": false,      "workspace": {        "gid": "1126509132283071",        "resource_type": "workspace",        "name": "Prismatic"      },      "team": {        "gid": "1202178854270529",        "resource_type": "team",        "name": "Engineering"      },      "permalink_url": "https://app.asana.com/0/1202461680419124/1202461680419124",      "is_template": false,      "default_view": "board",      "start_on": null,      "color": "light-green",      "icon": "board",      "completed": false,      "completed_at": null,      "completed_by": null,      "owner": {        "gid": "1202178852626547",        "resource_type": "user",        "name": "Example User"      },      "members": [        {          "gid": "1202178852626547",          "resource_type": "user",          "name": "Example User"        }      ],      "followers": [        {          "gid": "1202178852626547",          "resource_type": "user",          "name": "Example User"        }      ]    }  }}

Update Section#

Update the information and metadata of a project section | key: updateSection

InputNotesExample
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
Insert After
string
Notes
The ID of the field or section to insert this one insert after
Example
843750385
Input
Insert before
string
Notes
The ID of the field or section to insert this one before
Example
843750385
Input
Section ID
string
/ Required
Notes
The unique identifier of the section
Example
843750385
Input
Section Name
string
/ Required
Notes
Provide a value for the name of the section
Example
843750385

Output Example Payload#

{  "data": {    "data": {      "gid": "1202178854270533",      "resource_type": "section",      "created_at": "2022-04-25T19:28:56.749Z",      "name": "My New Section Name",      "project": {        "gid": "1202178854270532",        "resource_type": "project"      }    }  }}

Update Tag#

Update the information and metadata of the given tag | key: updateTag

InputDefaultNotesExample
Input
Connection
connection
/ Required
Default
 
Notes
 
Example
 
Input
Color
string
/ Required
Default
light-green
Notes
Provide a value for the color of the object.
Example
 
Input
Name
string
Default
Notes
Name of the project. This is generally a short sentence fragment that fits on a line in the UI for maximum readability.
Example
Example - Populate customers page with live data
Input
Notes
text
Default
Notes
Free-form textual information associated with the object (ie., its description).
Example
These are some example notes.
Input
Tag ID
string
/ Required
Default
Notes
The unique identifier of the tag
Example
843750385

Output Example Payload#

{  "data": {    "data": {      "gid": "1202461644189657",      "resource_type": "tag",      "created_at": "2022-06-16T22:04:33.095Z",      "name": "My Updated Tag Name",      "notes": "My Updated Notes",      "workspace": {        "gid": "1126509132283071",        "resource_type": "workspace"      },      "color": "dark-green",      "followers": []    }  }}

Update Task#

Update the information and metadata of the given task | key: updateTask

InputNotesExample
Input
Approval Status
string
Notes
Provide a string value for the approval status of the task.
Example
Pending
Input
Connection
connection
/ Required
Notes
 
Example
 
Input
Assignee ID
string
Notes
Provide the unique identifier of the assignee.
Example
843750385
Input
Assignee Section ID
string
Notes
Provide the unique identifier of the section to assign the task to. The assignee section is a subdivision of a project that groups tasks together in the assignee's 'My Tasks' list.
Example
843750385
Input
Assignee Status
string
Notes
Provide a string value representing the status the task has in relation to its assignee. This field is deprecated, you can still use it to form requests but it is not recommended for creating new records.
Example
upcoming
Input
Completed By
string
Notes
Provide a string value for the name of the user who completed the task. You can also provide a userId, or email.
Example
John Doe
Input
Due At
string
Notes
Provide an ISO 8601 date string in UTC and should NOT be used together with Due On.
Example
2019-09-15T02:06:58.147Z
Input
Due On
string
Notes
The date in which the project is due. This field takes a date with YYYY-MM-DD format and should not be used together with due_at.
Example
2019-09-15
Input
Completed
string
Notes
True if the task is completed, false if not. Select 'Do not change' to avoid updating this value.
Example
 
Input
Is Liked
string
Notes
This flag will mark the specified task as 'liked' in your Asana account.
Example
 
Input
Name
string
Notes
Name of the project. This is generally a short sentence fragment that fits on a line in the UI for maximum readability.
Example
Example - Populate customers page with live data
Input
Notes
text
Notes
Free-form textual information associated with the object (ie., its description).
Example
These are some example notes.
Input
Parent ID
string
Notes
Provide the unique identifier of the parent element.
Example
843750385
Input
Resource Subtype
string
Notes
Provide a string value for the type of object.
Example
task
Input
Start On
string
Notes
The day on which work for this project begins, or null if the project has no start date. This takes a date with YYYY-MM-DD format
Example
2021-11-14
Input
Task ID
string
/ Required
Notes
Provide the unique identifier for the task.
Example
375893453
Input
Workspace ID
string
Notes
The gid of the workspace
Example
375893453

Output Example Payload#

{  "data": {    "data": {      "gid": "1202461395122529",      "projects": [],      "memberships": [],      "resource_type": "task",      "created_at": "2022-06-16T21:15:12.578Z",      "modified_at": "2022-06-16T21:15:14.361Z",      "name": "My new task name",      "is_rendered_as_separator": false,      "notes": "Here's my task notes!",      "assignee": {        "gid": "1202178852626547",        "resource_type": "user"      },      "completed": false,      "assignee_status": "inbox",      "completed_at": null,      "due_on": null,      "due_at": null,      "resource_subtype": "default_task",      "start_on": null,      "tags": [],      "workspace": {        "gid": "1126509132283071",        "resource_type": "workspace"      },      "num_likes": 0,      "html_notes": "<body>Here's my task notes!</body>",      "parent": null,      "liked": false,      "likes": [],      "followers": []    }  }}