Asana Connector

Source API Docs API Changelog Connector Changelog

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 an 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.

Connections

Personal Access Token

key: apiKey

A personal access token can be used for development and testing purposes. For production deployments, use the OAuth 2.0 connection to allow users to authenticate with their own Asana credentials.

Prerequisites

An active Asana account with permissions to create personal access tokens

Setup Steps

To generate a personal access token:

Log in to Asana and navigate to app.asana.com/0/my-apps
Click + Create new token
Enter a description for the token and click Create token
Copy the generated token value

Security Note

Personal access tokens are tied to the user account that created them and inherit that user's permissions. Store tokens securely and rotate them regularly.

Configure the Connection

Enter the Personal Access Token value into the connection configuration

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

Input	Notes	Example
Personal Access Token	The Asana Personal Access Token. Generate one from the Asana Developer Portal.	1/example

OAuth 2.0

key: oauth2

To connect to Asana using OAuth 2.0, create an OAuth application within Asana's developer portal. This allows users to authenticate with their Asana credentials.

Prerequisites

An active Asana account
Permissions to create OAuth applications in Asana

Setup Steps

Log in to Asana and navigate to app.asana.com/0/my-apps
Click Create new app
Enter a name for the application and agree to Asana's terms and conditions
Open OAuth from the left-hand menu
Click + Add redirect URL and enter the OAuth callback URL: https://oauth2.prismatic.io/callback
Copy the generated Client ID and Client secret values

Configure the Connection

Enter the Client ID and Client secret from the OAuth application
For Scopes, specify the required permissions using the format <resource>:<action>:
- Leave blank to request full access (all available scopes)
- Refer to Asana's OAuth scopes documentation for a complete list of available scopes

Recommended Scopes

Scope	Description
`default`	Basic access to user identity and workspace membership
`tasks:read`	Read tasks, subtasks, and task details
`tasks:write`	Create, update, and delete tasks
`projects:read`	Read projects and project details
`projects:write`	Create, update, and delete projects
`users:read`	Read user profiles and team membership
`workspaces:read`	Read workspace and organization details
`attachments:read`	Read file attachments on tasks
`attachments:write`	Upload and manage attachments
`webhooks:read`	Read webhook subscriptions
`webhooks:write`	Create and manage webhooks

Example scope configurations:

Read-only access: default tasks:read projects:read users:read workspaces:read
Task management: default tasks:read tasks:write projects:read users:read
Full project access: default tasks:read tasks:write projects:read projects:write users:read workspaces:read
Webhook-enabled: default tasks:read projects:read webhooks:read webhooks:write

Input	Notes	Example
Authorize URL	The OAuth 2.0 authorization URL for Asana.	https://app.asana.com/-/oauth_authorize
Client ID	The OAuth 2.0 client ID. Generate one from the Asana Developer Portal.
Client Secret	The OAuth 2.0 client secret. Generate one from the Asana Developer Portal.
Scopes	A space-separated list of OAuth scopes using the format `<resource>:<action>` (e.g., tasks:read, projects:write). Leave blank for full access. See Asana OAuth scopes for available values.	tasks:read projects:read users:read
Token URL	The OAuth 2.0 token URL for Asana.	https://app.asana.com/-/oauth_token

Triggers

Comments and Activity

Receive comment and activity notifications from Asana. Automatically creates and manages a webhook subscription for story events in the selected project. | key: storiesTrigger

Input	Notes	Example
Connection	The Asana connection to use.
Project ID	The unique identifier for 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

Example Payload for Comments and Activity⤓

Loading…

New and Updated Tasks

Checks for new and updated tasks in a selected Asana project on a configured schedule. | key: pollChangesTrigger

Input	Notes	Example
Connection	The Asana connection to use.
Project ID	The unique identifier for the project.	375893453
Show New Records	When true, tasks created since the last poll are returned in the trigger payload.	true
Show Updated Records	When true, tasks modified since the last poll are returned in the trigger payload.	true

The New and Updated Tasks polling trigger checks Asana on a configured schedule for tasks that were created or modified in a selected project since the last poll. Unlike webhook-based triggers, polling does not require webhook subscription management and works reliably for low-frequency monitoring scenarios.

How It Works

On each scheduled execution, the trigger:

Reads the last poll timestamp (lastPolledAt) from the polling state, defaulting to the current execution time on the first run
Calls the Asana /tasks endpoint with a modified_since filter scoped to the configured project, walking all paginated results
Partitions the returned tasks into created and updated buckets by comparing each task's created_at against the last poll timestamp. Tasks whose created_at is after the cutoff land in the created bucket. All others land in the updated bucket.
Persists the current execution time as the new lastPolledAt for the next run
Emits the partitioned results in the trigger payload, filtered by the Show New Records and Show Updated Records toggles

Returned Data

The trigger emits a payload with two arrays, created and updated, each containing task resources from the Asana API.

Example Payload

{
  "data": {
    "created": [
      {
        "gid": "1202178854270531",
        "name": "Newly created task",
        "created_at": "2026-05-20T14:00:00.000Z",
        "modified_at": "2026-05-20T14:00:00.000Z",
        "completed": false,
        "due_on": "2026-05-27",
        "assignee": { "gid": "1202178852626547", "resource_type": "user" },
        "resource_type": "task"
      }
    ],
    "updated": [
      {
        "gid": "1202178854270599",
        "name": "Recently updated task",
        "created_at": "2026-05-19T10:00:00.000Z",
        "modified_at": "2026-05-20T15:00:00.000Z",
        "completed": false,
        "due_on": "2026-05-30",
        "assignee": { "gid": "1202178852626547", "resource_type": "user" },
        "resource_type": "task"
      }
    ]
  }
}

Fields shown are representative. The full response object includes additional properties.

Example Payload for New and Updated Tasks⤓

Loading…

Project Tasks

Receive task notifications from Asana. Automatically creates and manages a webhook subscription for task events in the selected project. | key: projectTasksTrigger

Input	Notes	Example
Connection	The Asana connection to use.
Project ID	The unique identifier for 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

Example Payload for Project Tasks⤓

Loading…

Webhook

Receive and validate webhook requests from Asana for manually configured webhook subscriptions. | key: webhook

Example Payload for Webhook⤓

Loading…

Workspace Projects

Receive project notifications from Asana. Automatically creates and manages a webhook subscription for project events in the selected workspace. | key: workspaceProjectsTrigger

Input	Notes	Example
Connection	The Asana connection to use.
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 unique identifier for the workspace. Required when the account has multiple workspaces.	375893453

Example Payload for Workspace Projects⤓

Loading…

Data Sources

Select Attachment

Select an attachment from a dropdown menu. | key: selectAttachment | type: picklist

Input	Notes	Example
Connection	The Asana connection to use.
Task ID	The unique identifier for the task.	375893453

Example Payload for Select Attachment⤓

Loading…

Select Custom Field

Select a custom field from a dropdown menu. | key: selectCustomField | type: picklist

Input	Notes	Example
Connection	The Asana connection to use.
Workspace ID	The unique identifier for the workspace. Required when the account has multiple workspaces.	375893453

Example Payload for Select Custom Field⤓

Loading…

Select Portfolio

Select a portfolio from a dropdown menu. | key: selectPortfolio | type: picklist

Input	Notes	Example
Connection	The Asana connection to use.
Workspace ID	The unique identifier for the workspace. Required when the account has multiple workspaces.	375893453

Example Payload for Select Portfolio⤓

Loading…

Select Project

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

Input	Notes	Example
Connection	The Asana connection to use.
Team ID	The unique identifier for the team.	843750385
Workspace ID	The unique identifier for the workspace. Required when the account has multiple workspaces.	375893453

Select Section

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

Input	Notes	Example
Connection	The Asana connection to use.
Project ID	The unique identifier for the project.	375893453

Select Tag

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

Input	Notes	Example
Connection	The Asana connection to use.
Workspace ID	The unique identifier for the workspace. Required when the account has multiple workspaces.	375893453

Select Task

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

Input	Notes	Example
Assignee ID	The unique identifier of the user assigned to the task. Assignee ID must be provided with a Workspace ID.	843750385
Connection	The Asana connection to use.
Project ID	The unique identifier for the project.	375893453
Workspace ID	The unique identifier for the workspace. Required when the 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	The Asana connection to use.
Workspace ID	The unique identifier for the workspace. Required when the account has multiple workspaces.	375893453

Select User

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

Input	Notes	Example
Connection	The Asana connection to use.
Workspace ID	The unique identifier for the workspace. Required when the account has multiple workspaces.	375893453

Select Workspace

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

Input	Notes	Example
Connection	The Asana connection to use.

Actions

Add Custom Field to Portfolio

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

Input	Notes	Example
Connection	The Asana connection to use.
Field ID	The unique identifier for the custom field.	843750385
Insert After	The gid of a sibling field or section after which the new item will be inserted.	843750385
Insert Before	The gid of a sibling field or section before which the new item will be inserted.	843750385
Is Important	When true, the custom field is highlighted as important and displayed prominently in the Asana UI.	true
Portfolio ID	The unique identifier for the portfolio.	843750385

Example Payload for Add Custom Field to Portfolio⤓

Loading…

Add Custom Field to Project

Add a new custom field to an existing project. | key: addCustomFieldToProject

Input	Notes	Example
Connection	The Asana connection to use.
Field ID	The unique identifier for the custom field.	843750385
Insert After	The gid of a sibling field or section after which the new item will be inserted.	843750385
Insert Before	The gid of a sibling field or section before which the new item will be inserted.	843750385
Is Important	When true, the custom field is highlighted as important and displayed prominently in the Asana UI.	true
Project ID	The unique identifier for the project.	375893453

Example Payload for Add Custom Field to Project⤓

Loading…

Add Followers to Task

Add followers to an existing task. | key: addFollowersToTask

Input	Notes	Example
Connection	The Asana connection to use.
Followers List	A list of user gids to add as followers. Provide one user ID per entry.	843750385
Task ID	The unique identifier for the task.	375893453

Example Payload for Add Followers to Task⤓

Loading…

Add Tag to Task

Add a tag to an existing task. | key: addTagToTask

Input	Notes	Example
Connection	The Asana connection to use.
Tag ID	The unique identifier for the tag.	843750385
Task ID	The unique identifier for the task.	375893453

Example Payload for Add Tag to Task⤓

Loading…

Add Task to Section

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

Input	Notes	Example
Connection	The Asana connection to use.
Insert After	The gid of a sibling field or section after which the new item will be inserted.	843750385
Insert Before	The gid of a sibling field or section before which the new item will be inserted.	843750385
Section ID	The unique identifier for the section.	843750385
Task ID	The unique identifier for the task.	375893453

Example Payload for Add Task to Section⤓

Loading…

Add User to Team

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

Input	Notes	Example
Connection	The Asana connection to use.
Team ID	The unique identifier for the team.	843750385
User ID	The unique identifier for the user.	375893453

Example Payload for Add User to Team⤓

Loading…

Add User to Workspace

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

Input	Notes	Example
Connection	The Asana connection to use.
User ID	The unique identifier for the user.	375893453
Workspace ID	The unique identifier for the workspace. Required when the account has multiple workspaces.	375893453

Example Payload for Add User to Workspace⤓

Loading…

Add Users to Portfolio

Add existing users to the given portfolio. | key: addUserToPortfolio

Input	Notes	Example
Connection	The Asana connection to use.
Members	A list of users to add as members. Each value can be the string 'me', an email address, or the gid of a user.	843750385
Portfolio ID	The unique identifier for the portfolio.	843750385

Example Payload for Add Users to Portfolio⤓

Loading…

Add Users to Project

Add existing users to the given project. | key: addUserToProject

Input	Notes	Example
Connection	The Asana connection to use.
Members	A list of users to add as members. Each value can be the string 'me', an email address, or the gid of a user.	843750385
Project ID	The unique identifier for the project.	375893453

Example Payload for Add Users to Project⤓

Loading…

Attach File to Task

Attach a file to a task. | key: attachFileToTask

Input	Notes	Example
Connection	The Asana connection to use.
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	The unique identifier for the task.	375893453

Example Payload for Attach File to Task⤓

Loading…

Create Portfolio

Create a new portfolio. | key: createPortfolio

Input	Notes	Example
Connection	The Asana connection to use.
Color	The display color associated with the object in the Asana UI.	light-green
Public	When true, the resource is visible to every member of the team it belongs to.	false
Members	A list of users to add as members. Each value can be the string 'me', an email address, or the gid of a user.	843750385
Portfolio Name	The display name for the portfolio.	My Portfolio
Workspace ID	The unique identifier for the workspace. Required when the account has multiple workspaces.	375893453

Example Payload for Create Portfolio⤓

Loading…

Create Project

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

Input	Notes	Example
Archived	When true, the project is archived and hidden from the UI by default. Archived projects may be treated differently for queries.	false
Connection	The Asana connection to use.
Default View	The default view to display when opening the project in Asana.	list
Due On	The date the project or task is due. Format: YYYY-MM-DD. Should not be used together with Due At.	2019-09-15
Followers	A comma-separated list of user gids to add as followers of the resource.	8570756435,375893453
HTML Notes	The rich-text notes for the resource as HTML. See Rich text in the Asana API for supported markup.	`<body>Mittens is a <em>really</em> good cat.</body>`
Name	The display name of the resource. A short sentence fragment that fits on a single line in the UI for maximum readability.	Example - Populate customers page with live data
Notes	Free-form plain-text description associated with the resource. For rich formatting use HTML Notes instead.	These are some example notes.
Owner ID	The unique identifier of the user who will own the project. The owner has full administrative rights over the project.	375893453
Privacy Setting	The privacy setting of the project. Administrators in the organization may restrict these values.
Project Color	The display color associated with the project in the Asana UI.	light-green
Start On	The date work for this project begins, or null if no start date is set. Format: YYYY-MM-DD.	2021-11-14
Team ID	The team that this project is shared with. Only exists for projects in organizations — including this field for non-organization projects causes the request to fail.	375893453
Workspace ID	Include this value if you would like this project to be included in a workspace.	375893453

Example Payload for Create Project⤓

Loading…

Create Section

Create a new section within a project. | key: createSection

Input	Notes	Example
Connection	The Asana connection to use.
Connection	The Asana connection to use.
Insert After	The gid of a sibling field or section after which the new item will be inserted.	843750385
Insert Before	The gid of a sibling field or section before which the new item will be inserted.	843750385
Project ID	The unique identifier for the project.	375893453
Section Name	The display name for the section.	Untriaged

Example Payload for Create Section⤓

Loading…

Create Status Update

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

Input	Notes	Example
Connection	The Asana connection to use.
Limit	The maximum number of items to return per page (between 1 and 100).	20
Offset	The pagination offset token returned from a previous query that had a next_page property.	eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9
Project, Portfolio, or Goal ID	The unique identifier for the parent project, portfolio, or goal the status update belongs to.	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

Example Payload for Create Status Update⤓

Loading…

Create Tag

Create a new tag in a workspace. | key: createTag

Input	Notes	Example
Connection	The Asana connection to use.
Color	The display color associated with the object in the Asana UI.	light-green
Followers List	A list of user gids to add as followers. Provide one user ID per entry.	843750385
Name	The display name of the resource. A short sentence fragment that fits on a single line in the UI for maximum readability.	Example - Populate customers page with live data
Notes	Free-form plain-text description associated with the resource. For rich formatting use HTML Notes instead.	These are some example notes.
Workspace ID	The unique identifier for the workspace. Required when the account has multiple workspaces.	375893453

Example Payload for Create Tag⤓

Loading…

Create Task

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

Input	Notes	Example
Approval Status	The approval status to set on the task.	Pending
Connection	The Asana connection to use.
Assignee ID	The unique identifier of the user assigned to the task.	843750385
Assignee Section ID	The unique identifier for 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	The status the task has in relation to its assignee. This field is deprecated — it can still be used in requests but is not recommended for new records.	upcoming
Completed By	The name of the user who completed the task. A user gid or email address may also be provided to reference an existing Asana user.	John Doe
Due At	The date and time the task is due. Format: ISO 8601 in UTC. Should not be used together with Due On.	2019-09-15T02:06:58.147Z
Due On	The date the project or task is due. Format: YYYY-MM-DD. Should not be used together with Due At.	2019-09-15
Followers List	A list of user gids to add as followers. Provide one user ID per entry.	843750385
HTML Notes	The rich-text notes for the resource as HTML. See Rich text in the Asana API for supported markup.	`<body>Mittens is a <em>really</em> good cat.</body>`
Completed	Whether the task is marked as complete. Select 'Do not change' to leave the existing value untouched.
Is Liked	Whether the task is marked as 'liked' for the authenticated user. Select 'Do not change' to leave the existing value untouched.
Name	The display name of the resource. A short sentence fragment that fits on a single line in the UI for maximum readability.	Example - Populate customers page with live data
Notes	Free-form plain-text description associated with the resource. For rich formatting use HTML Notes instead.	These are some example notes.
Parent ID	The unique identifier of the parent element.	843750385
Project List	A list of project gids the task should belong to. Provide one project ID per entry.	843750385
Resource Subtype	The subtype of the resource (e.g., 'default_task', 'milestone'). See Asana resource subtypes for valid values.	task
Start At	The date and time work begins for the task, or null if the task has no start time. Format: ISO 8601 in UTC. Should not be used together with Start On. Due At must be present when setting or unsetting this parameter.	2019-09-14T02:06:58.147Z
Start On	The date work for this project begins, or null if no start date is set. Format: YYYY-MM-DD.	2021-11-14
Workspace ID	The unique identifier for the workspace. Required when the account has multiple workspaces.	375893453

Example Payload for Create Task⤓

Loading…

Create Team

Create a new team within an organization. | key: createTeam

Input	Notes	Example
Connection	The Asana connection to use.
Organization or Workspace ID	The unique identifier for the organization or workspace.	375893453
Description	Free-form description of the team's purpose, shown on the team page in Asana.	This is an example description
Name	The display name for the team.	Engineering Team

Example Payload for Create Team⤓

Loading…

Create Webhook

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

Input	Notes	Example
Connection	The Asana connection to use.
Webhook URL	Reference a flow's URL from the trigger payload
Filter	The filter parameters for the webhook expressed as a JSON array. See the Asana webhooks guide for available filter options.	`[ { "action": "changed", "fields": [ "due_at", "due_on", "dependencies" ], "resource_subtype": "milestone", "resource_type": "task" } ]`
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	The Asana connection to use.
Attachment ID	The unique identifier for the attachment.	843750385

Example Payload for Delete Attachment⤓

Loading…

Delete Instance Webhooks

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

Input	Notes	Example
Connection	The Asana connection to use.
Workspace ID	The unique identifier for the workspace. Required when the account has multiple workspaces.	375893453

Delete Portfolio

Delete an existing portfolio. | key: deletePortfolio

Input	Notes	Example
Connection	The Asana connection to use.
Portfolio ID	The unique identifier for the portfolio.	843750385

Example Payload for Delete Portfolio⤓

Loading…

Delete Project

Delete an existing project by ID. | key: deleteProjects

Input	Notes	Example
Connection	The Asana connection to use.
Project ID	The unique identifier for the project.	375893453

Example Payload for Delete Project⤓

Loading…

Delete Section

Delete an existing section. | key: deleteSection

Input	Notes	Example
Connection	The Asana connection to use.
Section ID	The unique identifier for the section.	843750385

Example Payload for Delete Section⤓

Loading…

Delete Status Update

Delete an existing status update. | key: deleteStatus

Input	Notes	Example
Connection	The Asana connection to use.
Status ID	The unique identifier for the status update.	375893453

Example Payload for Delete Status Update⤓

Loading…

Delete Tag

Delete an existing tag. | key: deleteTag

Input	Notes	Example
Connection	The Asana connection to use.
Limit	The maximum number of items to return per page (between 1 and 100).	20
Offset	The pagination offset token returned from a previous query that had a next_page property.	eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9
Tag ID	The unique identifier for the tag.	843750385

Example Payload for Delete Tag⤓

Loading…

Delete Task

Delete an existing task. | key: deleteTask

Input	Notes	Example
Connection	The Asana connection to use.
Task ID	The unique identifier for the task.	375893453

Example Payload for Delete Task⤓

Loading…

Delete Webhook

Delete an existing webhook by ID. | key: deleteWebhook

Input	Notes	Example
Connection	The Asana connection to use.
Webhook ID	The gid of the workspace	375893453

Example Payload for Delete Webhook⤓

Loading…

Find Tag by Name

Find a tag by name within a workspace. | key: findTagByName

Input	Notes	Example
Connection	The Asana connection to use.
Tag Name	Note: if multiple tags share a name, only one tag will be returned.
Workspace ID	The unique identifier for the workspace. Required when the account has multiple workspaces.	375893453

Example Payload for Find Tag by Name⤓

Loading…

Find Team by Name

Find a team by name within a workspace. | key: findTeamByName

Input	Notes	Example
Connection	The Asana connection to use.
Team Name	Note: if multiple teams share a name, only one team will be returned.
Workspace ID	The unique identifier for the workspace. Required when the account has multiple workspaces.	375893453

Example Payload for Find Team by Name⤓

Loading…

Find User by Name or Email

Find a user by name or email address within a workspace. | key: findUserByNameOrEmail

Input	Notes	Example
Connection	The Asana connection to use.
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 unique identifier for the workspace. Required when the account has multiple workspaces.	375893453

Example Payload for Find User by Name or Email⤓

Loading…

Find Workspace by Name

Find a workspace by name. | key: findWorkspaceByName

Input	Notes	Example
Connection	The Asana connection to use.
Workspace Name

Example Payload for Find Workspace by Name⤓

Loading…

Get Attachment

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

Input	Notes	Example
Connection	The Asana connection to use.
Attachment ID	The unique identifier for the attachment.	843750385

Example Payload for Get Attachment⤓

Loading…

Get Current User

Get information about the currently authenticated user. | key: getCurrentUser

Input	Notes	Example
Connection	The Asana connection to use.

Example Payload for Get Current User⤓

Loading…

Get Custom Field

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

Input	Notes	Example
Connection	The Asana connection to use.
Field ID	The unique identifier for the custom field.	843750385

Example Payload for Get Custom Field⤓

Loading…

Get Portfolio

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

Input	Notes	Example
Connection	The Asana connection to use.
Portfolio ID	The unique identifier for the portfolio.	843750385

Example Payload for Get Portfolio⤓

Loading…

Get Project

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

Input	Notes	Example
Connection	The Asana connection to use.
Project ID	The unique identifier for the project.	375893453

Example Payload for Get Project⤓

Loading…

Get Section

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

Input	Notes	Example
Connection	The Asana connection to use.
Section ID	The unique identifier for the section.	843750385

Example Payload for Get Section⤓

Loading…

Get Status Update

Get the information and metadata of a status update. | key: getStatusUpdate

Input	Notes	Example
Connection	The Asana connection to use.
Status ID	The unique identifier for the status update.	375893453

Example Payload for Get Status Update⤓

Loading…

Get Status Updates from Object

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

Input	Notes	Example
Connection	The Asana connection to use.
Limit	The maximum number of items to return per page (between 1 and 100).	20
Offset	The pagination offset token returned from a previous query that had a next_page property.	eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9
Project, Portfolio, or Goal ID	The unique identifier for the parent project, portfolio, or goal the status update belongs to.	375893453

Example Payload for Get Status Updates from Object⤓

Loading…

Get Tag

Get the information and metadata of a tag. | key: getTag

Input	Notes	Example
Connection	The Asana connection to use.
Tag ID	The unique identifier for the tag.	843750385

Example Payload for Get Tag⤓

Loading…

Get Task

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

Input	Notes	Example
Connection	The Asana connection to use.
Task ID	The unique identifier for the task.	375893453

Example Payload for Get Task⤓

Loading…

Get Team

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

Input	Notes	Example
Connection	The Asana connection to use.
Team ID	The unique identifier for the team.	843750385

Example Payload for Get Team⤓

Loading…

Get User

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

Input	Notes	Example
Connection	The Asana connection to use.
User ID	The unique identifier for the user.	375893453

Example Payload for Get User⤓

Loading…

Get Workspace

Get the information and metadata of the given workspace. | key: getWorkspace

Input	Notes	Example
Connection	The Asana connection to use.
Workspace ID	The unique identifier for the workspace. Required when the account has multiple workspaces.	375893453

Example Payload for Get Workspace⤓

Loading…

List Custom Fields

List all custom fields in a workspace. | key: listCustomFields

Input	Notes	Example
Connection	The Asana connection to use.
Limit	The maximum number of items to return per page (between 1 and 100).	20
Offset	The pagination offset token returned from a previous query that had a next_page property.	eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9
Workspace ID	The unique identifier for the workspace. Required when the account has multiple workspaces.	375893453

Example Payload for List Custom Fields⤓

Loading…

List Portfolio Items

List all items in a given portfolio. | key: listPortfolioItems

Input	Notes	Example
Connection	The Asana connection to use.
Limit	The maximum number of items to return per page (between 1 and 100).	20
Offset	The pagination offset token returned from a previous query that had a next_page property.	eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9
Portfolio ID	The unique identifier for the portfolio.	843750385

Example Payload for List Portfolio Items⤓

Loading…

List Portfolios

List portfolios that the authenticated user owns. | key: listPortfolios

Input	Notes	Example
Connection	The Asana connection to use.
Limit	The maximum number of items to return per page (between 1 and 100).	20
Offset	The pagination offset token returned from a previous query that had a next_page property.	eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9
Workspace ID	The unique identifier for the workspace. Required when the account has multiple workspaces.	375893453

Example Payload for List Portfolios⤓

Loading…

List Projects

List all projects accessible to the authenticated user. | key: listProjects

Input	Notes	Example
Connection	The Asana connection to use.
Limit	The maximum number of items to return per page (between 1 and 100).	20
Offset	The pagination offset token returned from a previous query that had a next_page property.	eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9
Workspace ID	The unique identifier for the workspace. Required when the account has multiple workspaces.	375893453

Example Payload for List Projects⤓

Loading…

List Sections

List all sections in a given project. | key: listSections

Input	Notes	Example
Connection	The Asana connection to use.
Limit	The maximum number of items to return per page (between 1 and 100).	20
Offset	The pagination offset token returned from a previous query that had a next_page property.	eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9
Project ID	The unique identifier for the project.	375893453

Example Payload for List Sections⤓

Loading…

List Subtasks

List all subtasks within a given task. | key: listSubtasks

Input	Notes	Example
Connection	The Asana connection to use.
Limit	The maximum number of items to return per page (between 1 and 100).	20
List All Nested Subtasks	When true, recursively lists subtasks of subtasks rather than only direct subtasks of the parent task.	false
Offset	The pagination offset token returned from a previous query that had a next_page property.	eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9
Task ID	The unique identifier for the task.	375893453

Example Payload for List Subtasks⤓

Loading…

List all tags accessible to the authenticated user. | key: listTags

Input	Notes	Example
Connection	The Asana connection to use.
Limit	The maximum number of items to return per page (between 1 and 100).	20
Offset	The pagination offset token returned from a previous query that had a next_page property.	eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9
Workspace ID	The unique identifier for the workspace. Required when the account has multiple workspaces.	375893453

Example Payload for List Tags⤓

Loading…

List Tags in Task

List all tags applied to a given task. | key: listTagsInTask

Input	Notes	Example
Connection	The Asana connection to use.
Limit	The maximum number of items to return per page (between 1 and 100).	20
Offset	The pagination offset token returned from a previous query that had a next_page property.	eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9
Task ID	The unique identifier for the task.	375893453

Example Payload for List Tags in Task⤓

Loading…

List Task Attachments

List all attachments in a given task. | key: listAttachments

Input	Notes	Example
Connection	The Asana connection to use.
Limit	The maximum number of items to return per page (between 1 and 100).	20
Offset	The pagination offset token returned from a previous query that had a next_page property.	eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9
Task ID	The unique identifier for the task.	375893453

Example Payload for List Task Attachments⤓

Loading…

List Tasks

List tasks within a workspace, project, or assignee scope. | key: listTasks

Input	Notes	Example
Connection	The Asana connection to use.
Assignee ID	The unique identifier of the user assigned to the task.	843750385
Limit	The maximum number of items to return per page (between 1 and 100).	20
Offset	The pagination offset token returned from a previous query that had a next_page property.	eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9
Project ID	The unique identifier for the project.	375893453
Workspace ID	The unique identifier for the workspace. Required when the account has multiple workspaces.	375893453

Specify a project, or a combination of an assignee and workspace.

Example Payload for List Tasks⤓

Loading…

List Teams

List all teams within a given workspace. | key: listTeams

Input	Notes	Example
Connection	The Asana connection to use.
Workspace ID	The unique identifier for the workspace. Required when the account has multiple workspaces.	375893453

Example Payload for List Teams⤓

Loading…

List Users

List all users accessible to the authenticated user. | key: listUsers

Input	Notes	Example
Connection	The Asana connection to use.
Limit	The maximum number of items to return per page (between 1 and 100).	20
Offset	The pagination offset token returned from a previous query that had a next_page property.	eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9
Workspace ID	Optionally filter by workspace ID	375893453

Example Payload for List Users⤓

Loading…

List Workspace Webhooks

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

Input	Notes	Example
Connection	The Asana connection to use.
Limit	The maximum number of items to return per page (between 1 and 100).	20
Offset	The pagination 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 unique identifier for the workspace. Required when the account has multiple workspaces.	375893453

Example Payload for List Workspace Webhooks⤓

Loading…

List Workspaces

List all workspaces accessible to the authenticated user. | key: listWorkspaces

Input	Notes	Example
Connection	The Asana connection to use.
Limit	The maximum number of items to return per page (between 1 and 100).	20
Offset	The pagination offset token returned from a previous query that had a next_page property.	eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9

Example Payload for List Workspaces⤓

Loading…

Raw Request

Send a raw HTTP request to Asana. | key: rawRequest

Input	Notes	Example
Connection	The Asana connection to use.
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	The Asana connection to use.
Task ID	The unique identifier for the task.	375893453

Example Payload for Remove Assignee from Task⤓

Loading…

Remove Custom Field from Portfolio

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

Input	Notes	Example
Connection	The Asana connection to use.
Field ID	The unique identifier for the custom field.	843750385
Portfolio ID	The unique identifier for the portfolio.	843750385

Example Payload for Remove Custom Field from Portfolio⤓

Loading…

Remove Custom Field from Project

Remove an existing custom field from an existing project. | key: removeCustomFieldFromProject

Input	Notes	Example
Connection	The Asana connection to use.
Field ID	The unique identifier for the custom field.	843750385
Project ID	The unique identifier for the project.	375893453

Example Payload for Remove Custom Field from Project⤓

Loading…

Remove Followers from Task

Remove followers from the given task. | key: removeFollowersFromTask

Input	Notes	Example
Connection	The Asana connection to use.
Followers List	A list of user gids to add as followers. Provide one user ID per entry.	843750385
Task ID	The unique identifier for the task.	375893453

Example Payload for Remove Followers from Task⤓

Loading…

Remove Portfolio Item

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

Input	Notes	Example
Connection	The Asana connection to use.
Item ID	The unique identifier for the item (a project or portfolio).	843750385
Portfolio ID	The unique identifier for the portfolio.	843750385

Example Payload for Remove Portfolio Item⤓

Loading…

Remove Tag from Task

Remove a tag from the given task. | key: removeTagFromTask

Input	Notes	Example
Connection	The Asana connection to use.
Tag ID	The unique identifier for the tag.	843750385
Task ID	The unique identifier for the task.	375893453

Example Payload for Remove Tag from Task⤓

Loading…

Remove Users from Portfolio

Remove existing users from the given portfolio. | key: removeUserFromPortfolio

Input	Notes	Example
Connection	The Asana connection to use.
Members	A list of users to add as members. Each value can be the string 'me', an email address, or the gid of a user.	843750385
Portfolio ID	The unique identifier for the portfolio.	843750385

Example Payload for Remove Users from Portfolio⤓

Loading…

Update Portfolio

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

Input	Notes	Example
Connection	The Asana connection to use.
Color	The display color associated with the object in the Asana UI.	light-green
Public	When true, the resource is visible to every member of the team it belongs to.	false
Portfolio ID	The unique identifier for the portfolio.	843750385
Portfolio Name	The display name for the portfolio.	My Portfolio
Workspace ID	The unique identifier for the workspace. Required when the account has multiple workspaces.	375893453

Example Payload for Update Portfolio⤓

Loading…

Update Project

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

Input	Notes	Example
Archived	When true, the project is archived and hidden from the UI by default. Archived projects may be treated differently for queries.	false
Connection	The Asana connection to use.
Default View	The default view to display when opening the project in Asana.
Due On	The date the project or task is due. Format: YYYY-MM-DD. Should not be used together with Due At.	2019-09-15
Followers	A comma-separated list of user gids to add as followers of the resource.	8570756435,375893453
HTML Notes	The rich-text notes for the resource as HTML. See Rich text in the Asana API for supported markup.	`<body>Mittens is a <em>really</em> good cat.</body>`
Name	The display name of the resource. A short sentence fragment that fits on a single line in the UI for maximum readability.	Example - Populate customers page with live data
Notes	Free-form plain-text description associated with the resource. For rich formatting use HTML Notes instead.	These are some example notes.
Owner ID	The unique identifier of the user who will own the project. The owner has full administrative rights over the project.	375893453
Privacy Setting	The privacy setting of the project. Administrators in the organization may restrict these values.
Project Color	The display color associated with the project in the Asana UI.	light-green
Project ID	The unique identifier for the project.	375893453
Start On	The date work for this project begins, or null if no start date is set. Format: YYYY-MM-DD.	2021-11-14
Team ID	The team that this project is shared with. Only exists for projects in organizations — including this field for non-organization projects causes the request to fail.	375893453

Example Payload for Update Project⤓

Loading…

Update Section

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

Input	Notes	Example
Connection	The Asana connection to use.
Insert After	The gid of a sibling field or section after which the new item will be inserted.	843750385
Insert Before	The gid of a sibling field or section before which the new item will be inserted.	843750385
Section ID	The unique identifier for the section.	843750385
Section Name	The display name for the section.	Untriaged

Example Payload for Update Section⤓

Loading…

Update Tag

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

Input	Notes	Example
Connection	The Asana connection to use.
Color	The display color associated with the object in the Asana UI.	light-green
Name	The display name of the resource. A short sentence fragment that fits on a single line in the UI for maximum readability.	Example - Populate customers page with live data
Notes	Free-form plain-text description associated with the resource. For rich formatting use HTML Notes instead.	These are some example notes.
Tag ID	The unique identifier for the tag.	843750385

Example Payload for Update Tag⤓

Loading…

Update Task

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

Input	Notes	Example
Approval Status	The approval status to set on the task.	Pending
Connection	The Asana connection to use.
Assignee ID	The unique identifier of the user assigned to the task.	843750385
Assignee Section ID	The unique identifier for 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	The status the task has in relation to its assignee. This field is deprecated — it can still be used in requests but is not recommended for new records.	upcoming
Completed By	The name of the user who completed the task. A user gid or email address may also be provided to reference an existing Asana user.	John Doe
Due At	The date and time the task is due. Format: ISO 8601 in UTC. Should not be used together with Due On.	2019-09-15T02:06:58.147Z
Due On	The date the project or task is due. Format: YYYY-MM-DD. Should not be used together with Due At.	2019-09-15
HTML Notes	The rich-text notes for the resource as HTML. See Rich text in the Asana API for supported markup.	`<body>Mittens is a <em>really</em> good cat.</body>`
Completed	Whether the task is marked as complete. Select 'Do not change' to leave the existing value untouched.
Is Liked	Whether the task is marked as 'liked' for the authenticated user. Select 'Do not change' to leave the existing value untouched.
Name	The display name of the resource. A short sentence fragment that fits on a single line in the UI for maximum readability.	Example - Populate customers page with live data
Notes	Free-form plain-text description associated with the resource. For rich formatting use HTML Notes instead.	These are some example notes.
Parent ID	The unique identifier of the parent element.	843750385
Resource Subtype	The subtype of the resource (e.g., 'default_task', 'milestone'). See Asana resource subtypes for valid values.	task
Start At	The date and time work begins for the task, or null if the task has no start time. Format: ISO 8601 in UTC. Should not be used together with Start On. Due At must be present when setting or unsetting this parameter.	2019-09-14T02:06:58.147Z
Start On	The date work for this project begins, or null if no start date is set. Format: YYYY-MM-DD.	2021-11-14
Task ID	The unique identifier for the task.	375893453
Workspace ID	The unique identifier for the workspace. Required when the account has multiple workspaces.	375893453

Example Payload for Update Task⤓

Loading…

Changelog

2026-05-26

Added New and Updated Tasks polling trigger that monitors a project for changes via the modified_since parameter on Asana's /tasks endpoint. Results are partitioned into created and updated buckets based on each task's created_at/modified_at ISO 8601 timestamps

2026-05-18

Webhook HMAC secrets are now persisted in crossFlowState keyed by context.flow.stableId so they survive deployments. The Webhook trigger continues to read its array of secrets, and the per-resource event triggers their single secret, from instance-state as a fallback when no crossFlowState value exists yet — customers whose webhooks are already registered see no interruption. The legacy instance-state slot is migrated to crossFlowState and cleared on the next inbound notification or heartbeat for that flow

2026-04-30

Updated spectral version

2026-03-31

Various modernizations and documentation updates

2026-03-16

Improved input field documentation with formatted URL links for better readability

2026-02-26

Added inline data sources for portfolios, custom fields, and attachments to enable dynamic dropdown selection

2025-12-02

Added support for granular scopes to the OAuth 2.0 connection, allowing users to request specific permissions (e.g., tasks:read, projects:write) instead of full account access

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

Asana Connector

Description​

A Note on Asana Pagination​

Connections​

Personal Access Token​

Prerequisites​

Setup Steps​

Configure the Connection​

OAuth 2.0​

Prerequisites​

Setup Steps​

Configure the Connection​

Recommended Scopes​

Triggers​

Comments and Activity​

New and Updated Tasks​

How It Works​

Returned Data​

Project Tasks​

Webhook​

Workspace Projects​

Data Sources​

Select Attachment​

Select Custom Field​

Select Portfolio​

Select Project​

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 Update​

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 Attachment​

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​

Description

A Note on Asana Pagination

Connections

Personal Access Token

Prerequisites

Setup Steps

Configure the Connection

OAuth 2.0

Prerequisites

Setup Steps

Configure the Connection

Recommended Scopes

Triggers

Comments and Activity

New and Updated Tasks

How It Works

Returned Data

Project Tasks

Webhook

Workspace Projects

Data Sources

Select Attachment

Select Custom Field

Select Portfolio

Select Project

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 Update

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 Attachment

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