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.

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.

Input	Notes	Example
Personal Access Token	Log in to https://app.asana.com/0/my-apps to fetch a personal access token for development purposes	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.

Input	Notes	Example
Authorize URL	The OAuth 2.0 Authorization URL for Asana	https://app.asana.com/-/oauth_authorize
Client ID	Generate from https://app.asana.com/0/my-apps/
Client secret	Generate from https://app.asana.com/0/my-apps/
Scopes	Asana does not support granular scopes.
Token URL	The OAuth 2.0 Token URL for Asana	https://app.asana.com/-/oauth_token

Triggers

Comments & Activity Trigger

Get notified when a comment or activity (task updates, changes, etc.) is created, updated, or deleted in a project. | key: storiesTrigger

Input	Notes	Example
Connection
Project ID	Provide the unique identifier of the project.	375893453
Trigger When Added	Determines if the webhook will trigger when a comment or activity is added.	true
Trigger When Changed	Determines if the webhook will trigger when a comment or activity is changed.	true
Trigger When Deleted	Determines if the webhook will trigger when a comment or activity is deleted.	true
Trigger When Removed	Determines if the webhook will trigger when a comment or activity is removed.	true
Trigger When Undeleted	Determines if the webhook will trigger when a comment or activity is undeleted.	true

Project Tasks Trigger

Get notified when a task is created, updated, or deleted in a project. | key: projectTasksTrigger

Input	Notes	Example
Connection
Project ID	Provide the unique identifier of the project.	375893453
Trigger When Added	Determines if the webhook will trigger when a task is added.	true
Trigger When Changed	Determines if the webhook will trigger when a task is changed.	true
Trigger When Deleted	Determines if the webhook will trigger when a task is deleted.	true
Trigger When Removed	Determines if the webhook will trigger when a task is removed.	true
Trigger When Undeleted	Determines if the webhook will trigger when a task is undeleted.	true

Webhook

Receive and validate webhook requests from Asana for webhooks you configure. | key: webhook

Workspace Projects Trigger

Get notified when a project is created, updated, or deleted in a workspace. | key: workspaceProjectsTrigger

Input	Notes	Example
Connection
Trigger When Added	Determines if the webhook will trigger when a project is added.	true
Trigger When Changed	Determines if the webhook will trigger when a project is changed.	true
Trigger When Deleted	Determines if the webhook will trigger when a project is deleted.	true
Trigger When Removed	Determines if the webhook will trigger when a project is removed.	true
Trigger When Undeleted	Determines if the webhook will trigger when a project is undeleted.	true
Workspace ID	The gid of the workspace. Required when account has multiple workspaces.	375893453

Data Sources

Select Projects

Select a project from a dropdown menu | key: selectProject | type: picklist

Input	Notes	Example
Connection
Team ID	Provide the unique identifier of the team.	843750385
Workspace ID	The gid of the workspace. Required when account has multiple workspaces.	375893453

Select Section

Select a section from a dropdown menu | key: selectSection | type: picklist

Input	Notes	Example
Connection
Project ID	Provide the unique identifier of the project.	375893453

Select Tag

Select a tag from a dropdown menu | key: selectTag | type: picklist

Input	Notes	Example
Connection
Workspace ID	The gid of the workspace. Required when account has multiple workspaces.	375893453

Select Task

Select a task from a dropdown menu | key: selectTask | type: picklist

Input	Notes	Example
Assignee ID	Provide the unique identifier of the assignee. Assignee ID must be provided with a Workspace ID.	843750385
Connection
Project ID	Provide the unique identifier of the project.	375893453
Workspace ID	The gid of the workspace. Required when account has multiple workspaces. Workspace ID must be provided with an Assignee ID.	375893453

Select Team

Select a team from a dropdown menu | key: selectTeam | type: picklist

Input	Notes	Example
Connection
Workspace ID	The gid of the workspace. Required when account has multiple workspaces.	375893453

Select User

Select a user from a dropdown menu | key: selectUser | type: picklist

Input	Notes	Example
Connection
Workspace ID	The gid of the workspace. Required when account has multiple workspaces.	375893453

Select Workspace

Select a workspace from a dropdown menu | key: selectWorkspace | type: picklist

Input	Notes	Example
Connection

Actions

Add Custom Field To Portfolio

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

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

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

Add Custom Field To Project

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

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

{
  "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

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

{
  "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

Input	Notes	Example
Connection
Tag ID	The unique identifier of the tag	843750385
Task ID	Provide the unique identifier for the task.	375893453

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

Add Task To Section

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

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

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

Add User To Team

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

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

{
  "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

Input	Notes	Example
Connection
User ID	The global ID of a user	375893453
Workspace ID	The gid of the workspace. Required when account has multiple workspaces.	375893453

{
  "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

Input	Notes	Example
Connection
Members	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.	843750385
Portfolio ID	Provide the unique identifier of the portfolio.	843750385

{
  "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

Input	Notes	Example
Connection
Members	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.	843750385
Project ID	Provide the unique identifier of the project.	375893453

{
  "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,
      "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

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

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

Create Portfolio

Create a new portfolio | key: createPortfolio

Input	Notes	Example
Connection
Color	Provide a value for the color of the object.	light-green
Public	True if the object is public to its team.	false
Members	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.	843750385
Portfolio Name	Give a name to the portfolio	My Portfolio
Workspace ID	The gid of the workspace. Required when account has multiple workspaces.	375893453

{
  "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

Input	Notes	Example
Archived	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.	false
Connection
Default View	The default view of the project.	list
Due On	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.	2019-09-15
Followers	Provide a comma separated string of users.	8570756435,375893453
HTML Notes	The notes of the text with formatting as HTML.
Name	Name of the project. This is generally a short sentence fragment that fits on a line in the UI for maximum readability.	Example - Populate customers page with live data
Notes	Free-form textual information associated with the object (ie., its description).	These are some example notes.
Owner ID	Provide the unique identifier of the owner of the project.	375893453
Privacy Setting	The privacy setting of the project. Note: Administrators in your organization may restrict these values.
Project Color	The default color for your project	light-green
Start On	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	2021-11-14
Team ID	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.	375893453
Workspace ID	Include this value if you would like this project to be included in a workspace.	375893453

{
  "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,
      "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

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

{
  "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

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

{
  "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

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

{
  "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

Input	Notes	Example
Approval Status	Provide a string value for the approval status of the task.	Pending
Connection
Assignee ID	Provide the unique identifier of the assignee.	843750385
Assignee Section ID	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.	843750385
Assignee Status	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.	upcoming
Completed By	Provide a string value for the name of the user who completed the task. You can also provide a userId, or email.	John Doe
Due At	Provide an ISO 8601 date string in UTC and should NOT be used together with Due On.	2019-09-15T02:06:58.147Z
Due On	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.	2019-09-15
Followers List	For each item, provide the unique identifier of an existing userId.	843750385
HTML Notes	The notes of the text with formatting as HTML.
Completed	True if the task is completed, false if not. Select 'Do not change' to avoid updating this value.
Is Liked	This flag will mark the specified task as 'liked' in your Asana account.
Name	Name of the project. This is generally a short sentence fragment that fits on a line in the UI for maximum readability.	Example - Populate customers page with live data
Notes	Free-form textual information associated with the object (ie., its description).	These are some example notes.
Parent ID	Provide the unique identifier of the parent element.	843750385
Project List	For each item, provide the unique identifier of the project.	843750385
Resource Subtype	Provide a string value for the type of object.	task
Start At	Date and time on which work begins for the task, or null if the task has no start time. This takes an ISO 8601 date string in UTC and should not be used together with start_on. Note: due_at must be present in the request when setting or unsetting the start_at parameter.	2019-09-14T02:06:58.147Z
Start On	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	2021-11-14
Workspace ID	The gid of the workspace. Required when account has multiple workspaces.	375893453

{
  "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

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

{
  "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": "Acme"
      }
    }
  }
}

Create Webhook

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

Input	Notes	Example
Connection
Webhook URL	Reference a flow's URL from the trigger payload
Filter	Specify the filter parameters for the webhook in JSON format
Resource ID	The GID of a project, portfolio, goal, task, etc - the resource to listen for	375893453

Delete Attachment

Delete an existing attachment | key: deleteAttachment

Input	Notes	Example
Connection
Attachment ID	Provide an id for the given attachment	843750385

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

Delete Instance Webhooks

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

Input	Notes	Example
Connection
Workspace ID	The gid of the workspace. Required when account has multiple workspaces.	375893453

Delete Portfolio

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

Input	Notes	Example
Connection
Portfolio ID	Provide the unique identifier of the portfolio.	843750385

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

Delete Project

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

Input	Notes	Example
Connection
Project ID	Provide the unique identifier of the project.	375893453

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

Delete Section

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

Input	Notes	Example
Connection
Section ID	The unique identifier of the section	843750385

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

Delete Status

Delete a status update | key: deleteStatus

Input	Notes	Example
Connection
Status ID	The gid of the status update	375893453

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

Delete Tag

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

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

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

Delete Task

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

Input	Notes	Example
Connection
Task ID	Provide the unique identifier for the task.	375893453

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

Delete Webhook

Delete a webhook by ID | key: deleteWebhook

Input	Notes	Example
Connection
Webhook ID	The gid of the workspace	375893453

{
  "data": {}
}

Find Tag by Name

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

Input	Notes	Example
Connection
Tag Name	Note: if multiple tags share a name, only one tag will be returned.
Workspace ID	The gid of the workspace. Required when account has multiple workspaces.	375893453

{
  "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

Input	Notes	Example
Connection
Team Name	Note: if multiple teams share a name, only one team will be returned.
Workspace ID	The gid of the workspace. Required when account has multiple workspaces.	375893453

{
  "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

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

{
  "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

Input	Notes	Example
Connection
Workspace Name

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

Get Attachments

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

Input	Notes	Example
Connection
Attachment ID	Provide an id for the given attachment	843750385

{
  "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

Input	Notes	Example
Connection

{
  "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

Input	Notes	Example
Connection
Field ID	The unique identifier of the field	843750385

{
  "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

Input	Notes	Example
Connection
Portfolio ID	Provide the unique identifier of the portfolio.	843750385

{
  "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

Input	Notes	Example
Connection
Project ID	Provide the unique identifier of the project.	375893453

{
  "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"
      },
      "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

Input	Notes	Example
Connection
Section ID	The unique identifier of the section	843750385

{
  "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

Input	Notes	Example
Connection
Status ID	The gid of the status update	375893453

{
  "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

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

{
  "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

Input	Notes	Example
Connection
Tag ID	The unique identifier of the tag	843750385

{
  "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

Input	Notes	Example
Connection
Task ID	Provide the unique identifier for the task.	375893453

{
  "data": {
    "data": {
      "gid": "75834703724",
      "projects": "",
      "resource_type": "task",
      "name": "MyTask",
      "notes": "These are my example task notes!",
      "completed": false,
      "resource_subtype": "default_task",
      "tags": "",
      "workspace": {
        "gid": "867452364563",
        "resource_type": "workspace",
        "name": "Example Workspace"
      },
      "custom_fields": {},
      "assignee": {
        "gid": "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

Input	Notes	Example
Connection
Team ID	Provide the unique identifier of the team.	843750385

{
  "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

Input	Notes	Example
Connection
User ID	The global ID of a user	375893453

{
  "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

Input	Notes	Example
Connection
Workspace ID	The gid of the workspace. Required when account has multiple workspaces.	375893453

{
  "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

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

{
  "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

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

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

List Portfolios

List portfolios that the authenticated user owns | key: listPortfolios

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

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

List Projects

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

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

{
  "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] / Acme 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"
        },
        "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

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

{
  "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

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

{
  "data": {
    "data": [
      {
        "gid": "1234567890123456",
        "assignee": null,
        "assignee_status": "upcoming",
        "completed": false,
        "completed_at": null,
        "created_at": "2023-11-10T00:29:54.363Z",
        "custom_fields": [],
        "dependencies": [],
        "dependents": [],
        "due_at": null,
        "due_on": null,
        "followers": [
          {
            "gid": "7890123456789012",
            "resource_type": "user"
          }
        ],
        "html_notes": "<body></body>",
        "is_rendered_as_separator": false,
        "liked": false,
        "likes": [],
        "memberships": [],
        "modified_at": "2023-11-10T00:31:18.774Z",
        "name": "Task",
        "notes": "",
        "num_likes": 0,
        "num_subtasks": 2,
        "parent": {
          "gid": "2345678901234567",
          "resource_type": "task"
        },
        "projects": [],
        "resource_type": "task",
        "start_on": null,
        "tags": [],
        "resource_subtype": "default_task",
        "workspace": {
          "gid": "8901234567890123",
          "resource_type": "workspace"
        }
      }
    ]
  }
}

List all tags in your account | key: listTags

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

{
  "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 all tags in a given task | key: listTagsInTask

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

{
  "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

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

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

List Tasks

Return a list of tasks | key: listTasks

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

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

{
  "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

Input	Notes	Example
Connection
Workspace ID	The gid of the workspace. Required when account has multiple workspaces.	375893453

{
  "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

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

{
  "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

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

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

List Workspaces

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

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

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

Raw Request

Send raw HTTP request to Asana | key: rawRequest

Input	Notes	Example
Connection
Data	The HTTP body payload to send to the URL.	{"exampleKey": "Example Data"}
File Data	File Data to be sent as a multipart form upload.	[{key: "example.txt", value: "My File Contents"}]
File Data File Names	File names to apply to the file data inputs. Keys must match the file data keys above.
Form Data	The Form Data to be sent as a multipart form upload.	[{"key": "Example Key", "value": new Buffer("Hello World")}]
Header	A list of headers to send with the request.	User-Agent: curl/7.64.1
Max Retry Count	The maximum number of retries to attempt. Specify 0 for no retries.	0
Method	The HTTP method to use.
Query Parameter	A list of query parameters to send with the request. This is the portion at the end of the URL similar to ?key1=value1&key2=value2.
Response Type	The type of data you expect in the response. You can request json, text, or binary data.	json
Retry On All Errors	If true, retries on all erroneous responses regardless of type. This is helpful when retrying after HTTP 429 or other 3xx or 4xx errors. Otherwise, only retries on HTTP 5xx and network errors.	false
Retry Delay (ms)	The delay in milliseconds between retries. This is used when 'Use Exponential Backoff' is disabled.	0
Timeout	The maximum time that a client will await a response to its request	2000
URL	Input the path only (/goals), The base URL is already included (https://app.asana.com/api/1.0). For example, to connect to https://app.asana.com/api/1.0/goals, only /goals is entered in this field.	/goals
Use Exponential Backoff	Specifies whether to use a pre-defined exponential backoff strategy for retries. When enabled, 'Retry Delay (ms)' is ignored.	false

Remove Assignee From Task

Remove the assignee from the given task | key: removeAssigneeFromTask

Input	Notes	Example
Connection
Task ID	Provide the unique identifier for the task.	375893453

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

Remove Custom Field From Portfolio

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

Input	Notes	Example
Connection
Field ID	The unique identifier of the field	843750385
Portfolio ID	Provide the unique identifier of the portfolio.	843750385

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

Remove Custom Field From Project

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

Input	Notes	Example
Connection
Field ID	The unique identifier of the field	843750385
Project ID	Provide the unique identifier of the project.	375893453

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

Remove Followers From Task

Remove followers from the given task | key: removeFollowersFromTask

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

{
  "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

Input	Notes	Example
Connection
Item ID	Provide the unique identifier of the Item.	843750385
Portfolio ID	Provide the unique identifier of the portfolio.	843750385

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

Remove Tag From Task

Remove a tag from the given task | key: removeTagFromTask

Input	Notes	Example
Connection
Tag ID	The unique identifier of the tag	843750385
Task ID	Provide the unique identifier for the task.	375893453

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

Remove Users From Portfolio

Remove existing users from the given portfolio | key: removeUserFromPortfolio

Input	Notes	Example
Connection
Members	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.	843750385
Portfolio ID	Provide the unique identifier of the portfolio.	843750385

{
  "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

Input	Notes	Example
Connection
Color	Provide a value for the color of the object.	light-green
Public	True if the object is public to its team.	false
Portfolio ID	Provide the unique identifier of the portfolio.	843750385
Portfolio Name	Give a name to the portfolio	My Portfolio
Workspace ID	The gid of the workspace. Required when account has multiple workspaces.	375893453

{
  "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

Input	Notes	Example
Archived	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.	false
Connection
Default View	The default view of the project.
Due On	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.	2019-09-15
Followers	Provide a comma separated string of users.	8570756435,375893453
HTML Notes	The notes of the text with formatting as HTML.
Name	Name of the project. This is generally a short sentence fragment that fits on a line in the UI for maximum readability.	Example - Populate customers page with live data
Notes	Free-form textual information associated with the object (ie., its description).	These are some example notes.
Owner ID	Provide the unique identifier of the owner of the project.	375893453
Privacy Setting	The privacy setting of the project. Note: Administrators in your organization may restrict these values.
Project Color	The default color for your project	light-green
Project ID	Provide the unique identifier of the project.	375893453
Start On	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	2021-11-14
Team ID	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.	375893453

{
  "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,
      "name": "My new project name",
      "notes": "My new project notes\n",
      "archived": false,
      "workspace": {
        "gid": "1126509132283071",
        "resource_type": "workspace",
        "name": "Acme"
      },
      "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

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

{
  "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

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

{
  "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

Input	Notes	Example
Approval Status	Provide a string value for the approval status of the task.	Pending
Connection
Assignee ID	Provide the unique identifier of the assignee.	843750385
Assignee Section ID	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.	843750385
Assignee Status	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.	upcoming
Completed By	Provide a string value for the name of the user who completed the task. You can also provide a userId, or email.	John Doe
Due At	Provide an ISO 8601 date string in UTC and should NOT be used together with Due On.	2019-09-15T02:06:58.147Z
Due On	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.	2019-09-15
HTML Notes	The notes of the text with formatting as HTML.
Completed	True if the task is completed, false if not. Select 'Do not change' to avoid updating this value.
Is Liked	This flag will mark the specified task as 'liked' in your Asana account.
Name	Name of the project. This is generally a short sentence fragment that fits on a line in the UI for maximum readability.	Example - Populate customers page with live data
Notes	Free-form textual information associated with the object (ie., its description).	These are some example notes.
Parent ID	Provide the unique identifier of the parent element.	843750385
Resource Subtype	Provide a string value for the type of object.	task
Start At	Date and time on which work begins for the task, or null if the task has no start time. This takes an ISO 8601 date string in UTC and should not be used together with start_on. Note: due_at must be present in the request when setting or unsetting the start_at parameter.	2019-09-14T02:06:58.147Z
Start On	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	2021-11-14
Task ID	Provide the unique identifier for the task.	375893453
Workspace ID	The gid of the workspace. Required when account has multiple workspaces.	375893453

{
  "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": []
    }
  }
}

Changelog

2025-10-17

Enhanced webhook lifecycle management with improved event trigger handling and automated cleanup.

2025-09-19

Added inline data sources for projects, sections, tags, tasks, teams, users, and workspaces to enhance data selection capabilities.

Manage users, projects, and teams in your Asana workspace

Description​

A Note on Asana Pagination​

Connections​

Asana Personal Access Token​

Asana OAuth 2.0 Connection​

Triggers​

Comments & Activity Trigger​

Project Tasks Trigger​

Webhook​

Workspace Projects Trigger​

Data Sources​

Select Projects​

Select Section​

Select Tag​

Select Task​

Select Team​

Select User​

Select Workspace​

Actions​

Add Custom Field To Portfolio​

Add Custom Field To Project​

Add Followers To Task​

Add Tag To Task​

Add Task To Section​

Add User To Team​

Add User To Workspace​

Add Users To Portfolio​

Add Users To Project​

Attach File to Task​

Create Portfolio​

Create Project​

Create Section​

Create Status Update​

Create Tag​

Create Task​

Create Team​

Create Webhook​

Delete Attachment​

Delete Instance Webhooks​

Delete Portfolio​

Delete Project​

Delete Section​

Delete Status​

Delete Tag​

Delete Task​

Delete Webhook​

Find Tag by Name​

Find Team by Name​

Find User by Name or Email​

Find Workspace by Name​

Get Attachments​

Get Current User​

Get Custom Field​

Get Portfolio​

Get Project​

Get Section​

Get Status Update​

Get Status Updates from Object​

Get Tag​

Get Task​

Get Team​

Get User​

Get Workspace​

List Custom Fields​

List Portfolio Items​

List Portfolios​

List Projects​

List Sections​

List Subtasks​

List Tags​

List Tags In Task​

List task attachments​

List Tasks​

List Teams​

List Users​

List Workspace Webhooks​

List Workspaces​

Raw Request​

Remove Assignee From Task​