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

# Asana

> How to set up the Asana connector, plus the actions and events that are available.

![Asana](https://stackone-logos.com/api/asana/filled/svg)

v2.0.0[See changelog](https://docs.stackone.com/connectors/asana/changelog.md)

[126 actions](#actions) · [10 events](#events) · 3 auth methods

Project Management

## Getting Started

**1. Create or Select a Project**

Set up a new project or select an existing one. See [Organizations & Projects](https://docs.stackone.com/gateway/concepts/organizations-and-projects.md).

**2. Configure the Connector**

Enable the connector and create a Connector Profile in your project. See [Setup Connector Profile](https://docs.stackone.com/gateway/quickstart.md#setup-connector-profile).

> [card] [Personal Access Token · Connector Profile](https://docs.stackone.com/connectors/asana/guides/connector-profile/personal-access-token.md)
>
> Best for personal scripts, testing, and single-user integrations. Quick to set up, no app registration required.

> [card] [Service Account Token · Connector Profile](https://docs.stackone.com/connectors/asana/guides/connector-profile/service-account-token.md)
>
> Requires an Asana Enterprise or Enterprise+ organization and a super admin to create the Service Account. Org-level bot...

> [card] [OAuth 2.0 · Connector Profile](https://docs.stackone.com/connectors/asana/guides/connector-profile/oauth-2-0.md)
>
> Requires registering an app in the Asana Developer Console. Supports granular scopes per resource type.

Optionally, configure receiving Events for Asana into StackOne.

> [card] [Webhooks setup](https://docs.stackone.com/connectors/asana/guides/webhook-setup.md)

**3. Link an Account**

Link an account [from the dashboard](https://docs.stackone.com/connect/managing-connectors/linking-accounts.md#link-from-the-dashboard) (or via [StackOne Hub](https://docs.stackone.com/embed/account-linking/overview)).

See the guide for the authentication type chosen in the Connector Profile:

> [card] [Personal Access Token · Link Account](https://docs.stackone.com/connectors/asana/guides/link-account/personal-access-token.md)

> [card] [Service Account Token · Link Account](https://docs.stackone.com/connectors/asana/guides/link-account/service-account-token.md)

> [card] [OAuth 2.0 · Link Account](https://docs.stackone.com/connectors/asana/guides/link-account/oauth-2-0.md)

**4. Use Actions**

Connect an AI platform to the linked account's actions. See [AI Platforms](https://docs.stackone.com/ai-platforms/overview.md).

Other ways to call actions are listed in [Protocols & SDKs](https://docs.stackone.com/connect/protocols-and-sdks.md).

## Actions

Authentication type

Select all
|
Clear

OAuth 2.0

Personal Access Token

Service Account Token

No auth methods found

Scopes

Select all
|
Clear

attachments:delete

attachments:read

custom\_fields:read

custom\_fields:write

goals:read

portfolios:read

portfolios:write

project\_templates:read

projects:delete

projects:read

projects:write

stories:read

stories:write

tags:read

tags:write

task\_templates:read

tasks:delete

tasks:read

tasks:write

team\_memberships:read

teams:read

time\_tracking\_entries:read

users:read

webhooks:delete

webhooks:read

webhooks:write

workspaces.typeahead:read

workspaces:read

No scopes found

126 actions

ActionDescriptionRequired scopes

List Attachments`asana_list_attachments`

Get all attachments for a specific parent object (task or project)

`attachments:read`

Get Attachment`asana_get_attachment`

Get details of a specific attachment

`attachments:read`

Delete Attachment`asana_delete_attachment`

Delete an attachment from a task or project

`attachments:delete`

Get Audit Log Events`asana_get_audit_log_events`

Get audit log events for enterprise security and compliance monitoring

List Custom Fields`asana_list_custom_fields`

Returns a list of the compact representation of all of the custom fields in a workspace

`custom_fields:read`

Get Custom Field`asana_get_custom_field`

Get details of a specific custom field

`custom_fields:read`

Create Custom Field`asana_create_custom_field`

Creates a new custom field in a workspace. Every custom field is required to be created in a specific workspace, and thi...

`custom_fields:write`

Update Custom Field`asana_update_custom_field`

A specific, existing custom field can be updated by making a PUT request on the URL for that custom field. Only the fiel...

`custom_fields:write`

Create Enum Option`asana_create_enum_option`

Creates an enum option and adds it to this custom field's list of enum options. A custom field can have at most 50 enum...

`custom_fields:write`

Update Enum Option`asana_update_enum_option`

Updates an existing enum option. Enum options are ordered by creation time with the most recently created at the top. Lo...

`custom_fields:write`

Add Custom Field To Project`asana_add_custom_field_to_project`

Custom fields are associated with projects by way of custom field settings. This method creates a setting for the projec...

`custom_fields:write`

Remove Custom Field From Project`asana_remove_custom_field_from_project`

Removes a custom field setting from a project

`custom_fields:write`

Add Custom Field To Portfolio`asana_add_custom_field_to_portfolio`

Custom fields are associated with portfolios by way of custom field settings. This method creates a setting for the port...

`custom_fields:write`

Remove Custom Field From Portfolio`asana_remove_custom_field_from_portfolio`

Removes a custom field setting from a portfolio

`custom_fields:write`

Add Dependencies`asana_add_dependencies`

Add one or more dependencies to a task (tasks that must be completed before this task)

`tasks:write`

Remove Dependencies`asana_remove_dependencies`

Remove one or more dependencies from a task

`tasks:write`

Add Dependents`asana_add_dependents`

Add one or more dependents to a task (tasks that depend on this task being completed)

`tasks:write`

Remove Dependents`asana_remove_dependents`

Remove one or more dependents from a task

`tasks:write`

Get Events`asana_get_events`

Get events on a resource for real-time change tracking

`tasks:read`

List Goals`asana_list_goals`

Get goals in a workspace or portfolio

`goals:read`

Get Goal`asana_get_goal`

Get details of a specific goal

`goals:read`

Create Goal`asana_create_goal`

Create a new goal in a workspace or team.

`goals:read`

Update Goal`asana_update_goal`

Update properties of an existing goal

`goals:read`

Delete Goal`asana_delete_goal`

Delete a goal

`goals:read`

Add Subgoal`asana_add_subgoal`

Add a subgoal to a parent goal

`goals:read`

Remove Subgoal`asana_remove_subgoal`

Remove a subgoal from a parent goal

`goals:read`

List Memberships`asana_list_memberships`

Get all memberships for a parent object (goal, project, portfolio, or custom\_field)

`team_memberships:read`

Get Membership`asana_get_membership`

Get details of a specific membership

`team_memberships:read`

Create Membership`asana_create_membership`

Add a user or team as a member of a goal, project, portfolio, or custom\_field

`team_memberships:read`

Update Membership`asana_update_membership`

Update an existing membership. Only the fields provided in the data block will be updated; any unspecified fields will r...

`team_memberships:read`

Delete Membership`asana_delete_membership`

Remove a member from a project or goal

`team_memberships:read`

Create Organization Export`asana_create_organization_export`

Request a complete export of an organization's data in JSON format (Enterprise+ only)

Get Organization Export`asana_get_organization_export`

Get the status and download URL of an organization export request

List Portfolios`asana_list_portfolios`

Get all portfolios in a workspace

`portfolios:read`

Get Portfolio`asana_get_portfolio`

Get details of a specific portfolio

`portfolios:read`

Create Portfolio`asana_create_portfolio`

Create a new portfolio in a workspace

`portfolios:write`

Update Portfolio`asana_update_portfolio`

Update properties of an existing portfolio

`portfolios:write`

Delete Portfolio`asana_delete_portfolio`

Delete a portfolio

`portfolios:write`

Get Portfolio Items`asana_get_portfolio_items`

Get all projects in a portfolio

`portfolios:read`

Add Item To Portfolio`asana_add_item_to_portfolio`

Add a project to a portfolio

`portfolios:write`

Remove Item From Portfolio`asana_remove_item_from_portfolio`

Remove a project from a portfolio

`portfolios:write`

Add Members To Project`asana_add_members_to_project`

Add users as members to a project

`projects:write`

Remove Members From Project`asana_remove_members_from_project`

Remove users from project members

`projects:write`

Add Followers To Project`asana_add_followers_to_project`

Add users as followers to a project

`projects:write`

Remove Followers From Project`asana_remove_followers_from_project`

Remove users from project followers

`projects:write`

List Projects`asana_list_projects`

Get all projects in a workspace

`projects:read`

Get Project`asana_get_project`

Get details of a specific project

`projects:read`

Create Project`asana_create_project`

Create a new project in a workspace or team. If the workspace for your project is an organization, you must also supply...

`projects:write`

Update Project`asana_update_project`

Update an existing project

`projects:write`

Delete Project`asana_delete_project`

Delete a project permanently

`projects:delete`

Get Project Tasks`asana_get_project_tasks`

Get all tasks in a project

`projects:read`

Duplicate Project`asana_duplicate_project`

Create a duplicate of a project

`projects:write`

List Project Templates`asana_list_project_templates`

Get all project templates in a workspace or team

`project_templates:read`

Get Project Template`asana_get_project_template`

Get details of a specific project template

`project_templates:read`

Instantiate Project Template`asana_instantiate_project_template`

Create a new project from a template

`projects:write`

Typeahead Search`asana_typeahead_search`

Search for objects in a workspace by name for autocomplete

`workspaces.typeahead:read`

Search Tasks`asana_search_tasks`

Advanced search for tasks in a workspace with multiple filters

`workspaces.typeahead:read`

List Sections`asana_list_sections`

Get all sections in a project (board columns or list headers)

`projects:read`

Get Section`asana_get_section`

Get details of a specific section

`projects:read`

Create Section`asana_create_section`

Create a new section in a project

`projects:write`

Update Section`asana_update_section`

Update properties of an existing section

`projects:write`

Delete Section`asana_delete_section`

Delete a section from a project

`projects:write`

Add Task To Section`asana_add_task_to_section`

Add a task to a specific section

`projects:write`

List Status Updates`asana_list_status_updates`

Returns the compact status update records for all updates on the object

`projects:read`

Get Status Update`asana_get_status_update`

Get details of a specific status update

`projects:read`

Create Status Update`asana_create_status_update`

Creates a new status update on an object. Returns the full record of the newly created status update. Requires either te...

`projects:write`

Delete Status Update`asana_delete_status_update`

Delete a status update

`projects:write`

List Stories`asana_list_stories`

Get all stories (activity feed and comments) for a task

`stories:read`

Get Story`asana_get_story`

Get details of a specific story

`stories:read`

Create Story`asana_create_story`

Adds a story to a task. This endpoint currently only allows for comment stories to be created. The comment will be autho...

`stories:write`

Update Story`asana_update_story`

Updates the story and returns the full record for the updated story. Only comment stories can have their text updated, a...

`stories:write`

Delete Story`asana_delete_story`

Delete a story/comment from a task

`stories:write`

List Subtasks`asana_list_subtasks`

Get all subtasks for a specific task

`tasks:read`

Create Subtask`asana_create_subtask`

Creates a new subtask and adds it to the parent task. Returns the full record for the newly created subtask

`tasks:write`

Set Parent Task`asana_set_parent_task`

Set or change the parent task for a task to make it a subtask

`tasks:write`

List Tags`asana_list_tags`

Get all tags in a workspace

`tags:read`

Get Tag`asana_get_tag`

Get details of a specific tag

`tags:read`

Create Tag`asana_create_tag`

Create a new tag in a workspace

`tags:write`

Update Tag`asana_update_tag`

Update properties of an existing tag

`tags:write`

Add Tag To Task`asana_add_tag_to_task`

Add a tag to a task

`tags:write`

Remove Tag From Task`asana_remove_tag_from_task`

Remove a tag from a task

`tags:write`

Duplicate Task`asana_duplicate_task`

Create a copy of an existing task with optional field inclusions

`tasks:write`

Add Followers To Task`asana_add_followers_to_task`

Add one or more followers to a task

`tasks:write`

Remove Followers From Task`asana_remove_followers_from_task`

Remove one or more followers from a task

`tasks:write`

Add Project To Task`asana_add_project_to_task`

Add a task to an additional project

`tasks:write`

Remove Project From Task`asana_remove_project_from_task`

Remove a task from a project

`tasks:write`

List Tasks`asana_list_tasks`

Returns the compact task records for some filtered set of tasks. Use one or more of the parameters provided to filter th...

`tasks:read`

Get Task`asana_get_task`

Get a single task by ID

`tasks:read`

Create Task`asana_create_task`

Create a new task in Asana

`tasks:write`

Update Task`asana_update_task`

Update an existing task in Asana

`tasks:write`

Delete Task`asana_delete_task`

Delete a task from Asana

`tasks:delete`

List Task Templates`asana_list_task_templates`

Get task templates from a project (Premium feature)

`task_templates:read`

Get Task Template`asana_get_task_template`

Get a single task template by ID (Premium feature)

`task_templates:read`

Instantiate Task From Template`asana_instantiate_task_from_template`

Creates and returns a job that will asynchronously handle the task instantiation

`tasks:write`

List Teams`asana_list_teams`

Get all teams in a workspace

`teams:read`

Get Team`asana_get_team`

Get details of a specific team

`teams:read`

Update Team`asana_update_team`

Update a team's properties and access controls

`teams:read`

Get Team Users`asana_get_team_users`

Get all users in a team

`teams:read`

Add User To Team`asana_add_user_to_team`

Add a user to a team

`teams:read`

Remove User From Team`asana_remove_user_from_team`

Remove a user from a team

`teams:read`

List Time Periods`asana_list_time_periods`

Get all time periods in a workspace, optionally filtered by date range

`goals:read`

Get Time Period`asana_get_time_period`

Get details of a specific time period

`goals:read`

List Time Tracking Entries`asana_list_time_tracking_entries`

Returns time tracking entries for a given task

`time_tracking_entries:read`

Get Time Tracking Entry`asana_get_time_tracking_entry`

Returns the complete time tracking entry record for a single time tracking entry

`time_tracking_entries:read`

Create Time Tracking Entry`asana_create_time_tracking_entry`

Creates a time tracking entry on a given task. Returns the record of the newly created time tracking entry

`time_tracking_entries:read`

Update Time Tracking Entry`asana_update_time_tracking_entry`

A specific, existing time tracking entry can be updated by making a PUT request on the URL for that time tracking entry....

`time_tracking_entries:read`

Delete Time Tracking Entry`asana_delete_time_tracking_entry`

Delete a time tracking entry

`time_tracking_entries:read`

List Users`asana_list_users`

Get all users in a workspace

`users:read`

Get User`asana_get_user`

Get details of a specific user

`users:read`

Get Current User`asana_get_current_user`

Get details of the authenticated user

`users:read`

Get User Favorites`asana_get_user_favorites`

Get a user's favorites

`users:read`

Get User Teams`asana_get_user_teams`

Get all teams a user belongs to

`users:read`

Get User Workspace Memberships`asana_get_user_workspace_memberships`

Get workspace memberships for a user

`users:read`

Get User Team Memberships`asana_get_user_team_memberships`

Get team memberships for a user

`users:read`

Get User Task List`asana_get_user_task_list`

Returns the full record for a user's task list

`users:read`

Get Tasks From User Task List`asana_get_tasks_from_user_task_list`

Returns the compact list of tasks in a user's My Tasks list. Note - Access control is enforced for this endpoint as with...

`users:read`

List Webhooks`asana_list_webhooks`

Get the compact representation of all webhooks your app has registered for the authenticated user in the given workspace

`webhooks:read`

Get Webhook`asana_get_webhook`

Returns the full record for the given webhook

`webhooks:read`

Create Webhook`asana_create_webhook`

Create a new webhook to receive notifications about changes to a resource

`webhooks:write`

Update Webhook`asana_update_webhook`

An existing webhook's filters can be updated by making a PUT request on the URL for that webhook. Note that the webhook'...

`webhooks:write`

Delete Webhook`asana_delete_webhook`

This method permanently removes a webhook. Note that it may be possible to receive a request that was already in flight...

`webhooks:delete`

List Workspaces`asana_list_workspaces`

Get all workspaces accessible to the authenticated user

`workspaces:read`

Get Workspace`asana_get_workspace`

Get details of a specific workspace

`workspaces:read`

Update Workspace`asana_update_workspace`

Update properties of a workspace

`workspaces:read`

Add User To Workspace`asana_add_user_to_workspace`

Add a user to a workspace or organization. The user can be referenced by their globally unique user ID or their email ad...

`users:read`

Remove User From Workspace`asana_remove_user_from_workspace`

Remove a user from a workspace or organization. The user making this call must be an admin in the workspace. The user ca...

`users:read`

## Events

Tags

Select all
|
Clear

Projects

Sections

Stories

Tasks

Webhooks

No tags found

10 events

EventDescriptionTags

Active Check`asana_active_check`

Completes Asana's X-Hook-Secret handshake and responds 200 OK to heartbeat pings and unrecognized deliveries.

Webhooks

Task Added`asana_webhook_task_added`

Fired when a task is added to a project or workspace.

Tasks

Task Changed`asana_webhook_task_changed`

Fired when a task is modified (name, assignee, due date, custom fields, etc.).

Tasks

Task Removed`asana_webhook_task_removed`

Fired when a task is removed from a project.

Tasks

Task Deleted`asana_webhook_task_deleted`

Fired when a task is permanently deleted.

Tasks

Project Added`asana_webhook_project_added`

Fired when a project is added to a portfolio, team, or workspace.

Projects

Story Added`asana_webhook_story_added`

Fired when a comment or activity story is added to a task.

TasksStories

Story Removed`asana_webhook_story_removed`

Fired when a story is removed from a task.

TasksStories

Section Added`asana_webhook_section_added`

Fired when a section is added to a project.

ProjectsSections

Section Changed`asana_webhook_section_changed`

Fired when a section's properties are modified (name, etc.).

ProjectsSections


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.