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

The Comments and Activity trigger receives comment and activity (story) notifications from Asana. It automatically creates and manages a webhook subscription for story events in the selected project.

How It Works

This is a lifecycle-managed webhook trigger:

On Instance Deploy: The trigger creates an Asana webhook subscription targeting the instance's flow URL, filtered to story events in the configured project. If a matching webhook already exists, creation is skipped.
On Instance Deletion: The trigger finds and deletes the corresponding Asana webhook subscription.

When Asana delivers a webhook notification, the trigger:

Handles the initial handshake challenge by echoing the X-Hook-Secret header and storing it for HMAC validation
Validates the HMAC-SHA256 signature on subsequent requests
Skips heartbeat events (empty events array) by routing them to the URL Verify branch
Enriches notification events with full story data fetched from the Asana API, then routes to the Notification branch

Branches

Branch	Routed When
URL Verify	Handshake challenge or heartbeat event
Notification	Comment and activity events

Returned Data

The Notification branch receives the Asana webhook payload with each event enriched with the full story object.

Example Payload

{
  "events": [
    {
      "user": {
        "gid": "1202178852626547",
        "resource_type": "user"
      },
      "created_at": "2026-05-20T14:00:00.000Z",
      "action": "added",
      "resource": {
        "gid": "1202178854270599",
        "resource_type": "story",
        "resource_subtype": "comment_added"
      },
      "parent": {
        "gid": "1202178854270531",
        "resource_type": "task",
        "resource_subtype": "default_task"
      },
      "story": {
        "gid": "1202178854270599",
        "resource_type": "story",
        "resource_subtype": "comment_added",
        "text": "Great progress on this task!",
        "created_by": {
          "gid": "1202178852626547",
          "resource_type": "user"
        }
      }
    }
  ]
}

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

Notes

The trigger filter inputs (Trigger When Added, Trigger When Changed, etc.) control which event actions are subscribed to. Only selected actions generate webhook deliveries.
Stories in Asana include comments, status changes, assignee changes, and other activity on tasks. The resource_subtype field distinguishes the type of activity.
If a story referenced in an event has been deleted before the trigger can fetch its details, the story field is set to an empty object and a warning is logged.

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

The Project Tasks trigger receives task notifications from Asana. It automatically creates and manages a webhook subscription for task events in the selected project.

How It Works

This is a lifecycle-managed webhook trigger:

On Instance Deploy: The trigger creates an Asana webhook subscription targeting the instance's flow URL, filtered to task events in the configured project. If a matching webhook already exists, creation is skipped.
On Instance Deletion: The trigger finds and deletes the corresponding Asana webhook subscription.

When Asana delivers a webhook notification, the trigger:

Handles the initial handshake challenge by echoing the X-Hook-Secret header and storing it for HMAC validation
Validates the HMAC-SHA256 signature on subsequent requests
Skips heartbeat events (empty events array) by routing them to the URL Verify branch
Enriches notification events with full task data fetched from the Asana API, then routes to the Notification branch

Branches

Branch	Routed When
URL Verify	Handshake challenge or heartbeat event
Notification	Task change events

Returned Data

The Notification branch receives the Asana webhook payload with each event enriched with the full task object.

Example Payload

{
  "events": [
    {
      "user": {
        "gid": "1202178852626547",
        "resource_type": "user"
      },
      "created_at": "2026-05-20T14:00:00.000Z",
      "action": "changed",
      "resource": {
        "gid": "1202178854270531",
        "resource_type": "task",
        "resource_subtype": "default_task"
      },
      "parent": {
        "gid": "1202178854270500",
        "resource_type": "project",
        "resource_subtype": "default_project"
      },
      "task": {
        "gid": "1202178854270531",
        "name": "Design review",
        "resource_type": "task",
        "completed": false,
        "assignee": {
          "gid": "1202178852626547",
          "resource_type": "user"
        }
      }
    }
  ]
}

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

Notes

The trigger filter inputs (Trigger When Added, Trigger When Changed, etc.) control which event actions are subscribed to. Only selected actions generate webhook deliveries.
If a task referenced in an event has been deleted before the trigger can fetch its details, the task field is set to an empty object and a warning is logged.

Example Payload for Project Tasks⤓

Loading…

Webhook

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

The Webhook trigger receives and validates incoming webhook requests from Asana for manually configured webhook subscriptions. It handles the full Asana webhook lifecycle including the initial handshake challenge, HMAC signature verification, and heartbeat detection.

How It Works

Asana webhooks follow a two-phase protocol:

Handshake (URL Verify): When a webhook subscription is first created, Asana sends a request with an X-Hook-Secret header. The trigger echoes the secret back, stores it for future HMAC validation, and routes the execution to the URL Verify branch.
Notification delivery: Subsequent requests carry an X-Hook-Signature header containing an HMAC-SHA256 digest of the request body. The trigger verifies the signature against the stored secret before processing:
- Heartbeat events (empty events array) are routed to the URL Verify branch and logged as debug messages.
- Notification events (non-empty events array) are routed to the Notification branch for processing.

Branches

Branch	Routed When
URL Verify	Handshake challenge or heartbeat event
Notification	Actual resource change events

Returned Data

The Notification branch receives the full Asana webhook payload containing an array of event objects.

Example Payload

{
  "events": [
    {
      "user": {
        "gid": "1202178852626547",
        "resource_type": "user"
      },
      "created_at": "2026-05-20T14:00:00.000Z",
      "action": "changed",
      "resource": {
        "gid": "1202178854270531",
        "resource_type": "task",
        "resource_subtype": "default_task"
      },
      "parent": {
        "gid": "1202178854270500",
        "resource_type": "project",
        "resource_subtype": "default_project"
      }
    }
  ]
}

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

Notes

This trigger is intended for manually configured webhook subscriptions created via the Asana API or the Create Webhook action. For automatic webhook lifecycle management, use the Workspace Projects, Project Tasks, or Comments and Activity triggers instead.
The trigger stores webhook secrets in cross-flow state and supports multiple secrets for scenarios where a resource has more than one active subscription.

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

The Workspace Projects trigger receives project notifications from Asana. It automatically creates and manages a webhook subscription for project events in the selected workspace.

How It Works

This is a lifecycle-managed webhook trigger:

On Instance Deploy: The trigger creates an Asana webhook subscription targeting the instance's flow URL, filtered to project events in the configured workspace. If a matching webhook already exists, creation is skipped.
On Instance Deletion: The trigger finds and deletes the corresponding Asana webhook subscription.

When Asana delivers a webhook notification, the trigger:

Handles the initial handshake challenge by echoing the X-Hook-Secret header and storing it for HMAC validation
Validates the HMAC-SHA256 signature on subsequent requests
Skips heartbeat events (empty events array) by routing them to the URL Verify branch
Enriches notification events with full task or story data fetched from the Asana API, then routes to the Notification branch

Branches

Branch	Routed When
URL Verify	Handshake challenge or heartbeat event
Notification	Project change events

Returned Data

The Notification branch receives the Asana webhook payload with enriched event data.

Example Payload

{
  "events": [
    {
      "user": {
        "gid": "1202178852626547",
        "resource_type": "user"
      },
      "created_at": "2026-05-20T14:00:00.000Z",
      "action": "added",
      "resource": {
        "gid": "1202178854270531",
        "resource_type": "project",
        "resource_subtype": "default_project"
      },
      "parent": {
        "gid": "1202178854270500",
        "resource_type": "workspace"
      }
    }
  ]
}

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

Notes

The trigger filter inputs (Trigger When Added, Trigger When Changed, etc.) control which event actions are subscribed to. Only selected actions generate webhook deliveries.
If the instance is redeployed, the existing webhook is preserved if the target URL and resource match.

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
Optional Properties	A comma-separated list of fields to include in the API response. The default value contains the standard fields for this action. Add or remove fields as needed.	name,created_at
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.
Optional Properties	A comma-separated list of fields to include in the API response. The default value contains the standard fields for this action. Add or remove fields as needed.	name,created_at
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
Optional Properties	A comma-separated list of fields to include in the API response. The default value contains the standard fields for this action. Add or remove fields as needed.	name,created_at
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
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.
Optional Properties	A comma-separated list of fields to include in the API response. The default value contains the standard fields for this action. Add or remove fields as needed.	name,created_at
Owner ID	The unique identifier of the user who will own the project. The owner has full administrative rights over the project.	375893453
Project Settings	Archived, Privacy Setting, and Project Color.
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.
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
Optional Properties	A comma-separated list of fields to include in the API response. The default value contains the standard fields for this action. Add or remove fields as needed.	name,created_at
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.
Pagination	Limit and offset for paginated results.
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.
Optional Properties	A comma-separated list of fields to include in the API response. The default value contains the standard fields for this action. Add or remove fields as needed.	name,created_at
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
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>`
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.
Optional Properties	A comma-separated list of fields to include in the API response. The default value contains the standard fields for this action. Add or remove fields as needed.	name,created_at
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
Scheduling	Due date, due timestamp, start date, and start timestamp.
Task Status	Assignee Status, Completed By, Completed, and Is Liked.
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.	https://hooks.site.io/trigger/example
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.
Pagination	Limit and offset for paginated results.
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.
Optional Properties	A comma-separated list of fields to include in the API response. The default value contains the standard fields for this action. Add or remove fields as needed.	name,created_at
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.
Optional Properties	A comma-separated list of fields to include in the API response. The default value contains the standard fields for this action. Add or remove fields as needed.	name,created_at
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
Optional Properties	A comma-separated list of fields to include in the API response. The default value contains the standard fields for this action. Add or remove fields as needed.	name,created_at

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
Optional Properties	A comma-separated list of fields to include in the API response. The default value contains the standard fields for this action. Add or remove fields as needed.	name,created_at

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.
Optional Properties	A comma-separated list of fields to include in the API response. The default value contains the standard fields for this action. Add or remove fields as needed.	name,created_at
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.
Optional Properties	A comma-separated list of fields to include in the API response. The default value contains the standard fields for this action. Add or remove fields as needed.	name,created_at
Pagination	Limit and offset for paginated results.
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.
Optional Properties	A comma-separated list of fields to include in the API response. The default value contains the standard fields for this action. Add or remove fields as needed.	name,created_at
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.
Optional Properties	A comma-separated list of fields to include in the API response. The default value contains the standard fields for this action. Add or remove fields as needed.	name,created_at
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.
Optional Properties	A comma-separated list of fields to include in the API response. The default value contains the standard fields for this action. Add or remove fields as needed.	name,created_at
Pagination	Limit and offset for paginated results.
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.
Pagination	Limit and offset for paginated results.
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.
Pagination	Limit and offset for paginated results.
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.
Optional Properties	A comma-separated list of fields to include in the API response. The default value contains the standard fields for this action. Add or remove fields as needed.	name,created_at
Pagination	Limit and offset for paginated results.
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.
Optional Properties	A comma-separated list of fields to include in the API response. The default value contains the standard fields for this action. Add or remove fields as needed.	name,created_at
Pagination	Limit and offset for paginated results.
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.
List All Nested Subtasks	When true, recursively lists subtasks of subtasks rather than only direct subtasks of the parent task.	false
Optional Properties	A comma-separated list of fields to include in the API response. The default value contains the standard fields for this action. Add or remove fields as needed.	name,created_at
Pagination	Limit and offset for paginated results.
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.
Optional Properties	A comma-separated list of fields to include in the API response. The default value contains the standard fields for this action. Add or remove fields as needed.	name,created_at
Pagination	Limit and offset for paginated results.
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.
Optional Properties	A comma-separated list of fields to include in the API response. The default value contains the standard fields for this action. Add or remove fields as needed.	name,created_at
Pagination	Limit and offset for paginated results.
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.
Pagination	Limit and offset for paginated results.
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
Optional Properties	A comma-separated list of fields to include in the API response. The default value contains the standard fields for this action. Add or remove fields as needed.	name,created_at
Pagination	Limit and offset for paginated results.
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.
Optional Properties	A comma-separated list of fields to include in the API response. The default value contains the standard fields for this action. Add or remove fields as needed.	name,created_at
Pagination	Limit and offset for paginated results.
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.
Pagination	Limit and offset for paginated results.
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.
Pagination	Limit and offset for paginated results.

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
Optional Properties	A comma-separated list of fields to include in the API response. The default value contains the standard fields for this action. Add or remove fields as needed.	name,created_at
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
Optional Properties	A comma-separated list of fields to include in the API response. The default value contains the standard fields for this action. Add or remove fields as needed.	name,created_at
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
Connection	The Asana connection to use.
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
Project ID	The unique identifier for the project.	375893453
Project Settings	Archived, Default View, Privacy Setting, and Project Color.
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
Optional Properties	A comma-separated list of fields to include in the API response. The default value contains the standard fields for this action. Add or remove fields as needed.	name,created_at
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.
Optional Properties	A comma-separated list of fields to include in the API response. The default value contains the standard fields for this action. Add or remove fields as needed.	name,created_at
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
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
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.
Optional Properties	A comma-separated list of fields to include in the API response. The default value contains the standard fields for this action. Add or remove fields as needed.	name,created_at
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
Scheduling	Due date, due timestamp, start date, and start timestamp.
Task ID	The unique identifier for the task.	375893453
Task Status	Approval Status, Assignee Status, Completed By, Completed, and Is Liked.
Workspace ID	The unique identifier for the workspace. Required when the account has multiple workspaces.	375893453

Example Payload for Update Task⤓

Loading…

Changelog

2026-08-05

Removed gid, resource_type, and layout from Optional Properties default values (Asana returns these fields automatically, so requesting them is unnecessary)

Restructured action inputs into structured objects for an improved user experience:

List actions (List Tasks, List Projects, List Portfolios, List Users, List Sections, and 11 others) group Limit and Offset into Pagination
Create Task and Update Task group Due At, Due On, Start At, and Start On into Scheduling, and status-related inputs into Task Status
Create Project and Update Project group settings inputs into Project Settings

2026-07-30

Added Optional Properties input to 21 actions across projects, tags, sections, custom fields, users, attachments, portfolios, status updates, and subtasks to customize which fields the API returns

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​

How It Works​

Branches​

Returned Data​

Notes​

New and Updated Tasks​

How It Works​

Returned Data​

Project Tasks​

How It Works​

Branches​

Returned Data​

Notes​

Webhook​

How It Works​

Branches​

Returned Data​

Notes​

Workspace Projects​

How It Works​

Branches​

Returned Data​

Notes​

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​

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

How It Works

Branches

Returned Data

Notes

New and Updated Tasks

How It Works

Returned Data

Project Tasks

How It Works

Branches

Returned Data

Notes

Webhook

How It Works

Branches

Returned Data

Notes

Workspace Projects

How It Works

Branches

Returned Data

Notes

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