Asana Connector
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.
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
- 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.integrations.acme.com/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
This connection uses OAuth 2.0, a common authentication mechanism for integrations. Read about how OAuth 2.0 works here.
| 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 for available values. | |
| 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. |
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:
- 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
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 | Comments | Default |
|---|---|---|
| Personal Access Token | The Asana Personal Access Token. Generate one from the Asana Developer Portal. |
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 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 for supported markup. | |
| Resource Subtype | The subtype of the resource (e.g., 'default_task', 'milestone'). See Asana resource subtypes 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 for available filter options. | |
| 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 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 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 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. |