---
title: "Asana Connector | Lansweeper Platform"
slug: "asana-connector"
description: "Connect to Asana using OAuth 2.0 or a personal access token to manage users, projects, and teams efficiently in your workspace."
status: "update"
updated: 2026-07-17T15:50:15Z
published: 2026-07-17T15:50:15Z
canonical: "docs.lansweeper.com/asana-connector"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lansweeper.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Asana Connector

Note on third‑party tools

              

We aim to provide accurate and helpful details about third‑party tools, but we can’t guarantee that this information is always complete or up to date. If you notice any discrepancies, feel free to share them in the feedback section below. For the most reliable information, please always refer to the third‑party tool’s official documentation.

[Asana](https://app.asana.com/) 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.

## Connections

### OAuth 2.0

Authenticate using OAuth 2.0.

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

1. Log in to Asana and navigate to [app.asana.com/0/my-apps](https://app.asana.com/0/my-apps)
2. Click **Create new app**
3. Enter a name for the application and agree to Asana's terms and conditions
4. Open **OAuth** from the left-hand menu
5. Click **+ Add redirect URL** and enter the OAuth callback URL: `https://oauth2.flowbuilder.eu.lansweeper.com/callback` for EU sites or `https://oauth2.flowbuilder.us.lansweeper.com/callback` for US sites
6. 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](https://developers.asana.com/docs/oauth-scopes) 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`

This connection uses OAuth 2.0, a common authentication mechanism for integrations. Read about how OAuth 2.0 works [here](/docs/oauth-20-connections).

| Input | Comments | Default |
| --- | --- | --- |
| 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](https://developers.asana.com/docs/oauth-scopes) for available values. |  |
| Client ID | The OAuth 2.0 client ID. Generate one from the [Asana Developer Portal](https://app.asana.com/0/my-apps). |  |
| Client Secret | The OAuth 2.0 client secret. Generate one from the [Asana Developer Portal](https://app.asana.com/0/my-apps). |  |

### Personal Access Token

Authenticate requests using an Asana Personal Access Token.

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:

1. Log in to Asana and navigate to [app.asana.com/0/my-apps](https://app.asana.com/0/my-apps)
2. Click **+ Create new token**
3. Enter a description for the token and click **Create token**
4. 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](https://developers.asana.com/docs/personal-access-token).

| Input | Comments | Default |
| --- | --- | --- |
| Personal Access Token | The Asana Personal Access Token. Generate one from the [Asana Developer Portal](https://app.asana.com/0/my-apps). |  |

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

| Input | Comments | Default |
| --- | --- | --- |
| Connection | The Asana connection to use. |  |
| Project ID | The unique identifier for the project. |  |
| 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 |

### New and Updated Tasks

Checks for new and updated tasks in a selected Asana project on a configured schedule.

| Input | Comments | Default |
| --- | --- | --- |
| Connection | The Asana connection to use. |  |
| Project ID | The unique identifier for the project. |  |
| 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 |

### Project Tasks

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

| Input | Comments | Default |
| --- | --- | --- |
| Connection | The Asana connection to use. |  |
| Project ID | The unique identifier for the project. |  |
| Trigger When Added | Determines if the webhook will trigger when a task is added. | true |
| Trigger When Changed | Determines if the webhook will trigger when a task is changed. | true |
| Trigger When Deleted | Determines if the webhook will trigger when a task is deleted. | true |
| Trigger When Removed | Determines if the webhook will trigger when a task is removed. | true |
| Trigger When Undeleted | Determines if the webhook will trigger when a task is undeleted. | true |

### Webhook

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

### Workspace Projects

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

| Input | Comments | Default |
| --- | --- | --- |
| Connection | The Asana connection to use. |  |
| Workspace ID | The unique identifier for the workspace. Required when the account has multiple workspaces. |  |
| 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 |

## Actions

### Add Custom Field to Portfolio

Add a custom field to an existing portfolio.

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

### Add Custom Field to Project

Add a new custom field to an existing project.

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

### Add Followers to Task

Add followers to an existing task.

| Input | Comments | Default |
| --- | --- | --- |
| Connection | The Asana connection to use. |  |
| Task ID | The unique identifier for the task. |  |
| Followers List | A list of user gids to add as followers. Provide one user ID per entry. |  |

### Add Tag to Task

Add a tag to an existing task.

| Input | Comments | Default |
| --- | --- | --- |
| Connection | The Asana connection to use. |  |
| Task ID | The unique identifier for the task. |  |
| Tag ID | The unique identifier for the tag. |  |

### Add Task to Section

Add an existing task to the given section of a project.

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

### Add Users to Portfolio

Add existing users to the given portfolio.

| Input | Comments | Default |
| --- | --- | --- |
| Connection | The Asana connection to use. |  |
| Portfolio ID | The unique identifier for the portfolio. |  |
| 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. |  |

### Add Users to Project

Add existing users to the given project.

| Input | Comments | Default |
| --- | --- | --- |
| Connection | The Asana connection to use. |  |
| Project ID | The unique identifier for the project. |  |
| 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. |  |

### Add User to Team

Add an existing user to the given team.

| Input | Comments | Default |
| --- | --- | --- |
| Team ID | The unique identifier for the team. |  |
| User ID | The unique identifier for the user. |  |
| Connection | The Asana connection to use. |  |

### Add User to Workspace

Add a new user to the given workspace.

| Input | Comments | Default |
| --- | --- | --- |
| Workspace ID | The unique identifier for the workspace. Required when the account has multiple workspaces. |  |
| User ID | The unique identifier for the user. |  |
| Connection | The Asana connection to use. |  |

### Attach File to Task

Attach a file to a task.

| Input | Comments | Default |
| --- | --- | --- |
| 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 |  |
| Task ID | The unique identifier for the task. |  |

### Create Portfolio

Create a new portfolio.

| Input | Comments | Default |
| --- | --- | --- |
| Connection | The Asana connection to use. |  |
| Color | The display color associated with the object in the Asana UI. | light-green |
| 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. |  |
| Portfolio Name | The display name for the portfolio. |  |
| Workspace ID | The unique identifier for the workspace. Required when the account has multiple workspaces. |  |
| Public | When true, the resource is visible to every member of the team it belongs to. | false |

### Create Project

Create a new project inside an existing team or organization.

| Input | Comments | Default |
| --- | --- | --- |
| Connection | The Asana connection to use. |  |
| Owner ID | The unique identifier of the user who will own the project. The owner has full administrative rights over the project. |  |
| Project Color | The display color associated with the project in the Asana UI. | light-green |
| Default View | The default view to display when opening the project in Asana. | list |
| Privacy Setting | The privacy setting of the project. Administrators in the organization may restrict these values. |  |
| Due On | The date the project or task is due. Format: YYYY-MM-DD. Should not be used together with Due At. |  |
| Archived | When true, the project is archived and hidden from the UI by default. Archived projects may be treated differently for queries. | false |
| Followers | A comma-separated list of user gids to add as followers of the resource. |  |
| Name | The display name of the resource. A short sentence fragment that fits on a single line in the UI for maximum readability. |  |
| HTML Notes | The rich-text notes for the resource as HTML. See [Rich text in the Asana API](https://developers.asana.com/docs/rich-text) for supported markup. |  |
| Notes | Free-form plain-text description associated with the resource. For rich formatting use HTML Notes instead. |  |
| Start On | The date work for this project begins, or null if no start date is set. Format: YYYY-MM-DD. |  |
| Workspace ID | Include this value if you would like this project to be included in a workspace. |  |
| 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. |  |

### Create Section

Create a new section within a project.

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

### Create Status Update

Create a status update on a project, portfolio, or goal.

| Input | Comments | Default |
| --- | --- | --- |
| Connection | The Asana connection to use. |  |
| Project, Portfolio, or Goal ID | The unique identifier for the parent project, portfolio, or goal the status update belongs to. |  |
| Status Title | The title of the project status update. |  |
| Status Text | The text content of the status update. |  |
| This represents the current state of the object |  | on_track |
| Limit | The maximum number of items to return per page (between 1 and 100). |  |
| Offset | The pagination offset token returned from a previous query that had a next_page property. |  |

### Create Tag

Create a new tag in a workspace.

| Input | Comments | Default |
| --- | --- | --- |
| Connection | The Asana connection to use. |  |
| Workspace ID | The unique identifier for the workspace. Required when the account has multiple workspaces. |  |
| Followers List | A list of user gids to add as followers. Provide one user ID per entry. |  |
| 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. |  |
| Notes | Free-form plain-text description associated with the resource. For rich formatting use HTML Notes instead. |  |

### Create Task

Create a new task inside a workspace or organization.

| Input | Comments | Default |
| --- | --- | --- |
| Connection | The Asana connection to use. |  |
| Approval Status | The approval status to set on the task. |  |
| Completed | Whether the task is marked as complete. Select 'Do not change' to leave the existing value untouched. |  |
| 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. |  |
| Assignee ID | The unique identifier of the user assigned to the task. |  |
| 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. |  |
| 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. |  |
| Workspace ID | The unique identifier for the workspace. Required when the account has multiple workspaces. |  |
| Start On | The date work for this project begins, or null if no start date is set. Format: YYYY-MM-DD. |  |
| 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. |  |
| HTML Notes | The rich-text notes for the resource as HTML. See [Rich text in the Asana API](https://developers.asana.com/docs/rich-text) for supported markup. |  |
| Resource Subtype | The subtype of the resource (e.g., 'default_task', 'milestone'). See [Asana resource subtypes](https://developers.asana.com/docs/object-hierarchy) for valid values. |  |
| Project List | A list of project gids the task should belong to. Provide one project ID per entry. |  |
| Parent ID | The unique identifier of the parent element. |  |
| Notes | Free-form plain-text description associated with the resource. For rich formatting use HTML Notes instead. |  |
| Name | The display name of the resource. A short sentence fragment that fits on a single line in the UI for maximum readability. |  |
| Is Liked | Whether the task is marked as 'liked' for the authenticated user. Select 'Do not change' to leave the existing value untouched. |  |
| Followers List | A list of user gids to add as followers. Provide one user ID per entry. |  |
| Due At | The date and time the task is due. Format: ISO 8601 in UTC. Should not be used together with Due On. |  |
| Due On | The date the project or task is due. Format: YYYY-MM-DD. Should not be used together with Due At. |  |

### Create Team

Create a new team within an organization.

| Input | Comments | Default |
| --- | --- | --- |
| Description | Free-form description of the team's purpose, shown on the team page in Asana. |  |
| Name | The display name for the team. |  |
| Organization or Workspace ID | The unique identifier for the organization or workspace. |  |
| Connection | The Asana connection to use. |  |

### Create Webhook

Create a webhook to send data from Asana to an instance URL.

| Input | Comments | Default |
| --- | --- | --- |
| Webhook URL | Reference a flow's URL from the trigger payload |  |
| Resource ID | The GID of a project, portfolio, goal, task, etc - the resource to listen for |  |
| Filter | The filter parameters for the webhook expressed as a JSON array. See the [Asana webhooks guide](https://developers.asana.com/docs/webhooks-guide) for available filter options. | `[ { "action": "changed", "fields": [ "due_at", "due_on", "dependencies" ], "resource_subtype": "milestone", "resource_type": "task" }]` |
| Connection | The Asana connection to use. |  |

### Delete Attachment

Delete an existing attachment.

| Input | Comments | Default |
| --- | --- | --- |
| Connection | The Asana connection to use. |  |
| Attachment ID | The unique identifier for the attachment. |  |

### Delete Instance Webhooks

Delete all Asana webhooks that point to a flow in this instance.

| Input | Comments | Default |
| --- | --- | --- |
| Connection | The Asana connection to use. |  |
| Workspace ID | The unique identifier for the workspace. Required when the account has multiple workspaces. |  |

### Delete Portfolio

Delete an existing portfolio.

| Input | Comments | Default |
| --- | --- | --- |
| Connection | The Asana connection to use. |  |
| Portfolio ID | The unique identifier for the portfolio. |  |

### Delete Project

Delete an existing project by ID.

| Input | Comments | Default |
| --- | --- | --- |
| Project ID | The unique identifier for the project. |  |
| Connection | The Asana connection to use. |  |

### Delete Section

Delete an existing section.

| Input | Comments | Default |
| --- | --- | --- |
| Connection | The Asana connection to use. |  |
| Section ID | The unique identifier for the section. |  |

### Delete Status Update

Delete an existing status update.

| Input | Comments | Default |
| --- | --- | --- |
| Connection | The Asana connection to use. |  |
| Status ID | The unique identifier for the status update. |  |

### Delete Tag

Delete an existing tag.

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

### Delete Task

Delete an existing task.

| Input | Comments | Default |
| --- | --- | --- |
| Connection | The Asana connection to use. |  |
| Task ID | The unique identifier for the task. |  |

### Delete Webhook

Delete an existing webhook by ID.

| Input | Comments | Default |
| --- | --- | --- |
| Connection | The Asana connection to use. |  |
| Webhook ID | The gid of the workspace |  |

### Find Tag by Name

Find a tag by name within a workspace.

| Input | Comments | Default |
| --- | --- | --- |
| 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. |  |

### Find Team by Name

Find a team by name within a workspace.

| Input | Comments | Default |
| --- | --- | --- |
| 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. |  |

### Find User by Name or Email

Find a user by name or email address within a workspace.

| Input | Comments | Default |
| --- | --- | --- |
| Connection | The Asana connection to use. |  |
| User's Full Name | Note: if multiple users share a name, only one user will be returned. |  |
| User's Email | Note: if multiple users share an email address, only one user will be returned. |  |
| Workspace ID | The unique identifier for the workspace. Required when the account has multiple workspaces. |  |

### Find Workspace by Name

Find a workspace by name.

| Input | Comments | Default |
| --- | --- | --- |
| Connection | The Asana connection to use. |  |
| Workspace Name |  |  |

### Get Attachment

Get the information and metadata of an attachment.

| Input | Comments | Default |
| --- | --- | --- |
| Connection | The Asana connection to use. |  |
| Attachment ID | The unique identifier for the attachment. |  |

### Get Current User

Get information about the currently authenticated user.

| Input | Comments | Default |
| --- | --- | --- |
| Connection | The Asana connection to use. |  |

### Get Custom Field

Get the information and metadata of a custom field.

| Input | Comments | Default |
| --- | --- | --- |
| Connection | The Asana connection to use. |  |
| Field ID | The unique identifier for the custom field. |  |

### Get Portfolio

Get the information and metadata of a portfolio.

| Input | Comments | Default |
| --- | --- | --- |
| Connection | The Asana connection to use. |  |
| Portfolio ID | The unique identifier for the portfolio. |  |

### Get Project

Get the information and metadata of a project by ID.

| Input | Comments | Default |
| --- | --- | --- |
| Project ID | The unique identifier for the project. |  |
| Connection | The Asana connection to use. |  |

### Get Section

Get the information and metadata of a section.

| Input | Comments | Default |
| --- | --- | --- |
| Connection | The Asana connection to use. |  |
| Section ID | The unique identifier for the section. |  |

### Get Status Update

Get the information and metadata of a status update.

| Input | Comments | Default |
| --- | --- | --- |
| Connection | The Asana connection to use. |  |
| Status ID | The unique identifier for the status update. |  |

### Get Status Updates from Object

Get status updates from a project, portfolio, or goal.

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

### Get Tag

Get the information and metadata of a tag.

| Input | Comments | Default |
| --- | --- | --- |
| Connection | The Asana connection to use. |  |
| Tag ID | The unique identifier for the tag. |  |

### Get Task

Get the information and metadata of a task.

| Input | Comments | Default |
| --- | --- | --- |
| Connection | The Asana connection to use. |  |
| Task ID | The unique identifier for the task. |  |

### Get Team

Get the information and metadata of a team.

| Input | Comments | Default |
| --- | --- | --- |
| Connection | The Asana connection to use. |  |
| Team ID | The unique identifier for the team. |  |

### Get User

Get the information and metadata of a user.

| Input | Comments | Default |
| --- | --- | --- |
| User ID | The unique identifier for the user. |  |
| Connection | The Asana connection to use. |  |

### Get Workspace

Get the information and metadata of the given workspace.

| Input | Comments | Default |
| --- | --- | --- |
| Workspace ID | The unique identifier for the workspace. Required when the account has multiple workspaces. |  |
| Connection | The Asana connection to use. |  |

### List Custom Fields

List all custom fields in a workspace.

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

### List Portfolio Items

List all items in a given portfolio.

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

### List Portfolios

List portfolios that the authenticated user owns.

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

### List Projects

List all projects accessible to the authenticated user.

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

### List Sections

List all sections in a given project.

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

### List Subtasks

List all subtasks within a given task.

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

### List Tags

List all tags accessible to the authenticated user.

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

### List Tags in Task

List all tags applied to a given task.

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

### List Task Attachments

List all attachments in a given task.

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

### List Tasks

List tasks within a workspace, project, or assignee scope.

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

### List Teams

List all teams within a given workspace.

| Input | Comments | Default |
| --- | --- | --- |
| Connection | The Asana connection to use. |  |
| Workspace ID | The unique identifier for the workspace. Required when the account has multiple workspaces. |  |

### List Users

List all users accessible to the authenticated user.

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

### List Workspaces

List all workspaces accessible to the authenticated user.

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

### List Workspace Webhooks

List all webhooks configured in Asana, including those for other integrations.

| Input | Comments | Default |
| --- | --- | --- |
| Connection | The Asana connection to use. |  |
| Workspace ID | The unique identifier for the workspace. Required when the account has multiple workspaces. |  |
| Show only instance webhooks | Show only webhooks that point to this instance | true |
| Limit | The maximum number of items to return per page (between 1 and 100). |  |
| Offset | The pagination offset token returned from a previous query that had a next_page property. |  |

### Raw Request

Send a raw HTTP request to Asana.

| Input | Comments | Default |
| --- | --- | --- |
| Connection | The Asana connection to use. |  |
| 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. |  |
| Method | The HTTP method to use. |  |
| Data | The HTTP body payload to send to the URL. |  |
| Form Data | The Form Data to be sent as a multipart form upload. |  |
| File Data | File Data to be sent as a multipart form upload. |  |
| File Data File Names | File names to apply to the file data inputs. Keys must match the file data keys above. |  |
| 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. |  |
| Header | A list of headers to send with the request. |  |
| Response Type | The type of data you expect in the response. You can request json, text, or binary data. | json |
| Timeout | The maximum time that a client will await a response to its request |  |
| Retry Delay (ms) | The delay in milliseconds between retries. This is used when 'Use Exponential Backoff' is disabled. | 0 |
| 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 |
| Max Retry Count | The maximum number of retries to attempt. Specify 0 for no retries. | 0 |
| 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.

| Input | Comments | Default |
| --- | --- | --- |
| Connection | The Asana connection to use. |  |
| Task ID | The unique identifier for the task. |  |

### Remove Custom Field from Portfolio

Remove a custom field from an existing portfolio.

| Input | Comments | Default |
| --- | --- | --- |
| Connection | The Asana connection to use. |  |
| Portfolio ID | The unique identifier for the portfolio. |  |
| Field ID | The unique identifier for the custom field. |  |

### Remove Custom Field from Project

Remove an existing custom field from an existing project.

| Input | Comments | Default |
| --- | --- | --- |
| Connection | The Asana connection to use. |  |
| Project ID | The unique identifier for the project. |  |
| Field ID | The unique identifier for the custom field. |  |

### Remove Followers from Task

Remove followers from the given task.

| Input | Comments | Default |
| --- | --- | --- |
| Connection | The Asana connection to use. |  |
| Task ID | The unique identifier for the task. |  |
| Followers List | A list of user gids to add as followers. Provide one user ID per entry. |  |

### Remove Portfolio Item

Remove an existing item from the given portfolio.

| Input | Comments | Default |
| --- | --- | --- |
| Connection | The Asana connection to use. |  |
| Portfolio ID | The unique identifier for the portfolio. |  |
| Item ID | The unique identifier for the item (a project or portfolio). |  |

### Remove Tag from Task

Remove a tag from the given task.

| Input | Comments | Default |
| --- | --- | --- |
| Connection | The Asana connection to use. |  |
| Task ID | The unique identifier for the task. |  |
| Tag ID | The unique identifier for the tag. |  |

### Remove Users from Portfolio

Remove existing users from the given portfolio.

| Input | Comments | Default |
| --- | --- | --- |
| Connection | The Asana connection to use. |  |
| Portfolio ID | The unique identifier for the portfolio. |  |
| 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. |  |

### Update Portfolio

Update the information and metadata of the given portfolio.

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

### Update Project

Update the information and metadata of a project.

| Input | Comments | Default |
| --- | --- | --- |
| Connection | The Asana connection to use. |  |
| Project ID | The unique identifier for the project. |  |
| Project Color | The display color associated with the project in the Asana UI. | light-green |
| Default View | The default view to display when opening the project in Asana. |  |
| Privacy Setting | The privacy setting of the project. Administrators in the organization may restrict these values. |  |
| Due On | The date the project or task is due. Format: YYYY-MM-DD. Should not be used together with Due At. |  |
| Archived | When true, the project is archived and hidden from the UI by default. Archived projects may be treated differently for queries. | false |
| Followers | A comma-separated list of user gids to add as followers of the resource. |  |
| Name | The display name of the resource. A short sentence fragment that fits on a single line in the UI for maximum readability. |  |
| Notes | Free-form plain-text description associated with the resource. For rich formatting use HTML Notes instead. |  |
| HTML Notes | The rich-text notes for the resource as HTML. See [Rich text in the Asana API](https://developers.asana.com/docs/rich-text) for supported markup. |  |
| Owner ID | The unique identifier of the user who will own the project. The owner has full administrative rights over the project. |  |
| Start On | The date work for this project begins, or null if no start date is set. Format: YYYY-MM-DD. |  |
| 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. |  |

### Update Section

Update the information and metadata of a project section.

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

### Update Tag

Update the information and metadata of the given tag.

| Input | Comments | Default |
| --- | --- | --- |
| Connection | The Asana connection to use. |  |
| Tag ID | The unique identifier for the tag. |  |
| 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. |  |
| Notes | Free-form plain-text description associated with the resource. For rich formatting use HTML Notes instead. |  |

### Update Task

Update the information and metadata of the given task.

| Input | Comments | Default |
| --- | --- | --- |
| Connection | The Asana connection to use. |  |
| Task ID | The unique identifier for the task. |  |
| Approval Status | The approval status to set on the task. |  |
| Completed | Whether the task is marked as complete. Select 'Do not change' to leave the existing value untouched. |  |
| 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. |  |
| Assignee ID | The unique identifier of the user assigned to the task. |  |
| 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. |  |
| 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. |  |
| Workspace ID | The unique identifier for the workspace. Required when the account has multiple workspaces. |  |
| 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. |  |
| Start On | The date work for this project begins, or null if no start date is set. Format: YYYY-MM-DD. |  |
| Resource Subtype | The subtype of the resource (e.g., 'default_task', 'milestone'). See [Asana resource subtypes](https://developers.asana.com/docs/object-hierarchy) for valid values. |  |
| Parent ID | The unique identifier of the parent element. |  |
| HTML Notes | The rich-text notes for the resource as HTML. See [Rich text in the Asana API](https://developers.asana.com/docs/rich-text) for supported markup. |  |
| Notes | Free-form plain-text description associated with the resource. For rich formatting use HTML Notes instead. |  |
| Name | The display name of the resource. A short sentence fragment that fits on a single line in the UI for maximum readability. |  |
| Is Liked | Whether the task is marked as 'liked' for the authenticated user. Select 'Do not change' to leave the existing value untouched. |  |
| Due At | The date and time the task is due. Format: ISO 8601 in UTC. Should not be used together with Due On. |  |
| Due On | The date the project or task is due. Format: YYYY-MM-DD. Should not be used together with Due At. |  |