Asana
Asana enables teams to manage their projects and tasks in one place.
This connector is available in the following products and regions:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Standard | All Power Automate regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Logic Apps | Standard | All Logic Apps regions except the following: - Azure Government regions - Azure China regions - US Department of Defense (DoD) |
| Power Apps | Standard | All Power Apps regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Power Automate | Standard | All Power Automate regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Connector Metadata | |
|---|---|
| Publisher | Microsoft |
| Website | https://asana.com/ |
| Privacy policy | https://asana.com/terms#privacy-policy |
Throttling Limits
| Name | Calls | Renewal Period |
|---|---|---|
| API calls per connection | 30 | 60 seconds |
| Frequency of trigger polls | 1 | 15 seconds |
Actions
| Add Comment (V2) |
This operation is used to add a comment to an existing task (V2). |
| Add Comment [DEPRECATED] |
This action has been deprecated. Please use Add Comment (V2) instead.
|
| Complete Task (V2) |
This operation is used to mark an existing task as complete (V2). |
| Complete Task [DEPRECATED] |
This action has been deprecated. Please use Complete Task (V2) instead.
|
| Create a new project (V2) |
This operation is used to create a new project (V2). |
| Create new project [DEPRECATED] |
This action has been deprecated. Please use Create a new project (V2) instead.
|
| Create Task (V2) |
This operation is used to create a new task in your Asana project (V2). |
| Create Task [DEPRECATED] |
This action has been deprecated. Please use Create Task (V2) instead.
|
| Get project by ID (V2) |
This operation retrieves project object by Project ID (V2). |
| Get project by ID [DEPRECATED] |
This action has been deprecated. Please use Get project by ID (V2) instead.
|
| Get task by ID (V2) |
This operation retrieves a task object by Task ID (V2). |
| Get task by ID [DEPRECATED] |
This action has been deprecated. Please use Get task by ID (V2) instead.
|
| Get user by ID (V2) |
This operation retrieves user object by User ID (V2). |
| Get user by ID [DEPRECATED] |
This action has been deprecated. Please use Get user by ID (V2) instead.
|
| List teams by workspace (V2) |
This operation is used to view teams in the workspace or organization (V2). |
| List teams by workspace [DEPRECATED] |
This action has been deprecated. Please use List teams by workspace (V2) instead.
|
| List users by workspace (V2) |
This operation retrieves the list of users for a given workspace (V2). |
| List users by workspace [DEPRECATED] |
This action has been deprecated. Please use List users by workspace (V2) instead.
|
Add Comment (V2)
This operation is used to add a comment to an existing task (V2).
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Task ID
|
task_id | True | string |
Unique id of the task. |
|
Comment
|
text | True | string |
Text to be used as comment. |
Returns
A comment on an Asana task.
- Body
- AddCommentResponseV2
Add Comment [DEPRECATED]
This action has been deprecated. Please use Add Comment (V2) instead.
This operation is used to add a comment to an existing task.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Task ID
|
task_id | True | string |
Unique id of the task. |
|
Comment
|
text | True | string |
Text to be used as comment. |
Returns
A comment on an Asana task.
- Body
- AddCommentResponse
Complete Task (V2)
This operation is used to mark an existing task as complete (V2).
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Task ID
|
task_id | True | string |
Unique id of the task. |
Returns
An Asana task.
- Body
- TaskResponseV2
Complete Task [DEPRECATED]
This action has been deprecated. Please use Complete Task (V2) instead.
This operation is used to mark an existing task as complete.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Task ID
|
task_id | True | string |
Unique id of the task. |
Returns
An Asana task.
- Body
- TaskResponse
Create a new project (V2)
This operation is used to create a new project (V2).
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Workspace ID
|
workspace | True | string |
Workspace to use for new projects. |
|
Team ID
|
team | string |
If creating in an organization, the specific team to create the project in. |
|
|
Project name
|
name | True | string |
Name of the project. |
|
Due date
|
due_date | date |
yyyy-MM-dd |
|
|
Public
|
public | boolean |
True if the project is public to the organization. |
|
|
Project color
|
color | string |
Color used to display the project. |
|
|
Project notes
|
notes | string |
Notes about the project. |
|
|
Owner
|
owner | string |
Owner of the project. |
|
|
Archive
|
archived | boolean |
Archived projects do not show in the UI by default. |
Returns
An Asana project.
- Body
- ProjectResponseV2
Create new project [DEPRECATED]
This action has been deprecated. Please use Create a new project (V2) instead.
This operation is used to create a new project.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Workspace ID
|
workspace | True | string |
Workspace to use for new projects. |
|
Team ID
|
team | string |
If creating in an organization, the specific team to create the project in. |
|
|
Project name
|
name | True | string |
Name of the project. |
|
Due date
|
due_date | date |
yyyy-MM-dd |
|
|
Public
|
public | boolean |
True if the project is public to the organization. |
|
|
Project color
|
color | string |
Color used to display the project. |
|
|
Project notes
|
notes | string |
Notes about the project. |
|
|
Owner
|
owner | string |
Owner of the project. |
|
|
Archive
|
archived | boolean |
Archived projects do not show in the UI by default. |
Returns
An Asana project.
- Body
- ProjectResponse
Create Task (V2)
This operation is used to create a new task in your Asana project (V2).
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Workspace ID
|
workspace | True | string |
Workspace to use for your projects. |
|
Project ID
|
projects | True | string |
Project |
|
Task name
|
name | True | string |
Name of the task. |
|
Assignee
|
assignee | string |
Email or User ID, defaults to current user. |
|
|
Description
|
notes | string |
Description of the task. |
|
|
Assignee status
|
assignee_status | string |
Scheduling status of the task. |
|
|
Completed
|
completed | boolean |
Indicate if the task will be marked as completed. |
|
|
Due date
|
due_on | date |
Due date of the task. |
Returns
An Asana task.
- Body
- TaskResponseV2
Create Task [DEPRECATED]
This action has been deprecated. Please use Create Task (V2) instead.
This operation is used to create a new task in your Asana project.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Workspace ID
|
workspace | True | string |
Workspace to use for your projects. |
|
Project ID
|
projects | True | string |
Project |
|
Task name
|
name | True | string |
Name of the task. |
|
Assignee
|
assignee | string |
'Email or User ID, defaults to current user. |
|
|
Description
|
notes | string |
Description of the task. |
|
|
Assignee status
|
assignee_status | string |
Scheduling status of the task. |
|
|
Completed
|
completed | boolean |
Indicate if the task will be marked as completed. |
|
|
Due date
|
due_on | date |
Due date of the task. |
Returns
An Asana task.
- Body
- TaskResponse
Get project by ID (V2)
This operation retrieves project object by Project ID (V2).
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Project ID
|
project_id | True | string |
The ID of the Project. |
Returns
An Asana project.
- Body
- ProjectResponseV2
Get project by ID [DEPRECATED]
This action has been deprecated. Please use Get project by ID (V2) instead.
This operation retrieves project object by Project ID.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Project ID
|
project_id | True | string |
The ID of the Project. |
Returns
An Asana project.
- Body
- ProjectResponse
Get task by ID (V2)
This operation retrieves a task object by Task ID (V2).
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Task ID
|
task_id | True | string |
Unique id of the task. |
Returns
An Asana task.
- Body
- TaskResponseV2
Get task by ID [DEPRECATED]
This action has been deprecated. Please use Get task by ID (V2) instead.
This operation retrieves a task object by Task ID.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Task ID
|
task_id | True | string |
Unique id of the task. |
Returns
An Asana task.
- Body
- TaskResponse
Get user by ID (V2)
This operation retrieves user object by User ID (V2).
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
User
|
user_id | True | string |
User |
Returns
An Asana user.
- Body
- UserResponseV2
Get user by ID [DEPRECATED]
This action has been deprecated. Please use Get user by ID (V2) instead.
This operation retrieves user object by User ID.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
User
|
user_id | True | string |
User |
Returns
An Asana user.
- Body
- UserResponse
List teams by workspace (V2)
This operation is used to view teams in the workspace or organization (V2).
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Workspace ID
|
workspace | True | string |
Workspace or Organization ID. |
Returns
- Body
- ListTeamsResponseV2
List teams by workspace [DEPRECATED]
This action has been deprecated. Please use List teams by workspace (V2) instead.
This operation is used to view teams in the workspace or organization.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Workspace ID
|
workspace | True | string |
Workspace or Organization ID. |
Returns
- Body
- ListTeamsResponse
List users by workspace (V2)
This operation retrieves the list of users for a given workspace (V2).
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Workspace ID
|
workspace_id | True | string |
Workspace to monitor for users. |
Returns
- Body
- ListUsersResponseV2
List users by workspace [DEPRECATED]
This action has been deprecated. Please use List users by workspace (V2) instead.
This operation retrieves the list of users for a given workspace.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Workspace ID
|
workspace_id | True | string |
Workspace to monitor for users. |
Returns
- Body
- ListUsersResponse
Triggers
| When a project is created (V2) |
Triggers when a new project is created (V2). |
| When a project is created [DEPRECATED] |
This action has been deprecated. Please use When a project is created (V2) instead.
|
| When a task is completed (V2) |
Triggers when an existing task is completed (V2). |
| When a task is completed [DEPRECATED] |
This action has been deprecated. Please use When a task is completed (V2) instead.
|
| When a task is created (V2) |
Triggers when a new task is created (V2). |
| When a task is created [DEPRECATED] |
This action has been deprecated. Please use When a task is created (V2) instead.
|
When a project is created (V2)
Triggers when a new project is created (V2).
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Workspace ID
|
workspace | True | string |
Workspace to monitor for new projects. |
Returns
When a project is created [DEPRECATED]
This action has been deprecated. Please use When a project is created (V2) instead.
Triggers when a new project is created.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Workspace ID
|
workspace | True | string |
Workspace to monitor for new projects. |
Returns
- Body
- ListProjectsResponse
When a task is completed (V2)
Triggers when an existing task is completed (V2).
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Workspace ID
|
workspace | True | string |
Workspace to monitor for new projects. |
|
Project ID
|
project | True | string |
Project |
Returns
- Body
- ListTasksResponseV2
When a task is completed [DEPRECATED]
This action has been deprecated. Please use When a task is completed (V2) instead.
Triggers when an existing task is completed.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Workspace ID
|
workspace | True | string |
Workspace to monitor for new projects. |
|
Project ID
|
project | True | string |
Project |
Returns
- Body
- ListTasksResponse
When a task is created (V2)
Triggers when a new task is created (V2).
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Workspace ID
|
workspace | True | string |
Workspace to monitor for new projects. |
|
Project ID
|
project | True | string |
Project |
Returns
- Body
- ListTasksResponseV2
When a task is created [DEPRECATED]
This action has been deprecated. Please use When a task is created (V2) instead.
Triggers when a new task is created.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Workspace ID
|
workspace | True | string |
Workspace to monitor for new projects. |
|
Project ID
|
project | True | string |
Project |
Returns
- Body
- ListTasksResponse
Definitions
ListProjectsResponse
| Name | Path | Type | Description |
|---|---|---|---|
|
Projects
|
data | array of ProjectResponse |
ProjectResponse
An Asana project.
| Name | Path | Type | Description |
|---|---|---|---|
|
Project ID
|
id | integer | |
|
Project name
|
name | string | |
|
Project notes
|
notes | string | |
|
Created date
|
created_at | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
Modified date
|
modified_at | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
Owner
|
owner | Owner |
The project owner. |
|
Due date
|
due_date | date |
yyyy-MM-dd |
|
Status
|
current_status | CurrentStatus | |
|
Public
|
public | boolean | |
|
Archived
|
archived | boolean | |
|
Workspace
|
workspace | WorkSpace |
The workspace. |
|
Color
|
color | string |
Project color. |
ListTasksResponse
| Name | Path | Type | Description |
|---|---|---|---|
|
Tasks
|
data | array of TaskResponse |
TaskResponse
An Asana task.
| Name | Path | Type | Description |
|---|---|---|---|
|
Task ID
|
id | integer | |
|
Created date
|
created_at | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
Modified date
|
modified_at | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
Task name
|
name | string | |
|
Task notes
|
notes | string | |
|
Completed
|
completed | boolean | |
|
Assignee
|
assignee | Assignee |
The user to whom this task is assigned. |
|
Asignee status
|
assignee_status | string |
Scheduling status of the task. |
|
Completed date and time
|
completed_at | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
Due date
|
due_on | date |
yyyy-MM-dd |
|
Due date and time
|
due_at | string |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
Workspace
|
workspace | WorkSpace |
The workspace. |
|
Number of likes
|
num_hearts | integer | |
|
Liked
|
hearted | boolean |
AddCommentResponse
A comment on an Asana task.
| Name | Path | Type | Description |
|---|---|---|---|
|
Task
|
data.target | Target |
The task that this comment is associated with. |
|
Text
|
data.text | string |
The text of the comment. |
|
Creation date
|
data.created_at | string |
The date and time at which this comment was created. |
|
Author
|
data.created_by | CreatedBy |
The user that authored this comment. |
|
Source
|
data.source | string |
The component of the Asana product the user used to trigger the comment. |
|
Type
|
data.type | string |
The type of comment this is. |
|
Comment ID
|
data.id | integer |
The ID for this comment. |
ListTeamsResponse
| Name | Path | Type | Description |
|---|---|---|---|
|
data
|
data | array of object | |
|
Team ID
|
data.id | integer |
Globally unique ID of the team. |
ListUsersResponse
| Name | Path | Type | Description |
|---|---|---|---|
|
Users
|
data | array of UserResponse |
UserResponse
An Asana user.
| Name | Path | Type | Description |
|---|---|---|---|
|
User ID
|
id | integer | |
|
User name
|
name | string | |
|
Email
|
string |
CurrentStatus
| Name | Path | Type | Description |
|---|---|---|---|
|
color
|
color | string |
The color status of the project. |
|
text
|
text | string |
Text describing the project status. |
|
ID
|
author.id | integer |
ID of the author of the project status. |
|
name
|
author.name | string |
Name of the author of the project status. |
WorkSpace
The workspace.
| Name | Path | Type | Description |
|---|---|---|---|
|
ID
|
id | integer | |
|
name
|
name | string |
Owner
The project owner.
| Name | Path | Type | Description |
|---|---|---|---|
|
ID
|
id | integer |
The ID of the project owner. |
|
name
|
name | string |
The name of the project owner. |
Assignee
The user to whom this task is assigned.
| Name | Path | Type | Description |
|---|---|---|---|
|
ID
|
id | integer | |
|
name
|
name | string |
Target
The task that this comment is associated with.
| Name | Path | Type | Description |
|---|---|---|---|
|
ID
|
id | integer |
The ID of the task that this comment is associated with. |
|
name
|
name | string |
The ID of the task that this comment is associated with. |
CreatedBy
The user that authored this comment.
| Name | Path | Type | Description |
|---|---|---|---|
|
ID
|
id | integer |
The ID of the user that authored this comment. |
|
name
|
name | string |
The name of the user that authored this comment. |
ListProjectsResponseV2
| Name | Path | Type | Description |
|---|---|---|---|
|
Projects
|
data | array of ProjectResponseV2 |
ProjectResponseV2
An Asana project.
| Name | Path | Type | Description |
|---|---|---|---|
|
Project ID
|
gid | string | |
|
Project name
|
name | string | |
|
Project notes
|
notes | string | |
|
Created date
|
created_at | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
Modified date
|
modified_at | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
Owner
|
owner | OwnerV2 |
The project owner. |
|
Due date
|
due_date | date |
yyyy-MM-dd |
|
Status
|
current_status | CurrentStatusV2 | |
|
Public
|
public | boolean | |
|
Archived
|
archived | boolean | |
|
Workspace
|
workspace | WorkSpaceV2 |
The workspace. |
|
Color
|
color | string |
Project color. |
ListTasksResponseV2
| Name | Path | Type | Description |
|---|---|---|---|
|
Tasks
|
data | array of TaskResponseV2 |
TaskResponseV2
An Asana task.
| Name | Path | Type | Description |
|---|---|---|---|
|
Task ID
|
gid | string | |
|
Created date
|
created_at | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
Modified date
|
modified_at | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
Task name
|
name | string | |
|
Task notes
|
notes | string | |
|
Completed
|
completed | boolean | |
|
Assignee
|
assignee | AssigneeV2 |
The user to whom this task is assigned. |
|
Asignee status
|
assignee_status | string |
Scheduling status of the task. |
|
Completed date and time
|
completed_at | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
Due date
|
due_on | date |
yyyy-MM-dd |
|
Due date and time
|
due_at | string |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
Workspace
|
workspace | WorkSpaceV2 |
The workspace. |
|
Number of likes
|
num_hearts | integer | |
|
Permanent Url
|
permalink_url | string |
Permanent Url for the task. |
|
Liked
|
hearted | boolean |
AddCommentResponseV2
A comment on an Asana task.
| Name | Path | Type | Description |
|---|---|---|---|
|
Task
|
data.target | TargetV2 |
The task that this comment is associated with. |
|
Text
|
data.text | string |
The text of the comment. |
|
Creation date
|
data.created_at | string |
The date and time at which this comment was created. |
|
Author
|
data.created_by | CreatedByV2 |
The user that authored this comment. |
|
Source
|
data.source | string |
The component of the Asana product the user used to trigger the comment. |
|
Type
|
data.type | string |
The type of comment this is. |
|
Comment ID
|
data.gid | string |
The ID for this comment. |
ListTeamsResponseV2
| Name | Path | Type | Description |
|---|---|---|---|
|
data
|
data | array of object | |
|
Team ID
|
data.gid | string |
Globally unique ID of the team. |
ListUsersResponseV2
| Name | Path | Type | Description |
|---|---|---|---|
|
Users
|
data | array of UserResponseV2 |
UserResponseV2
An Asana user.
| Name | Path | Type | Description |
|---|---|---|---|
|
User ID
|
gid | string | |
|
User name
|
name | string | |
|
Email
|
string |
CurrentStatusV2
| Name | Path | Type | Description |
|---|---|---|---|
|
color
|
color | string |
The color status of the project. |
|
text
|
text | string |
Text describing the project status. |
|
ID
|
author.gid | string |
ID of the author of the project status. |
|
name
|
author.name | string |
Name of the author of the project status. |
WorkSpaceV2
The workspace.
| Name | Path | Type | Description |
|---|---|---|---|
|
ID
|
gid | string | |
|
name
|
name | string |
OwnerV2
The project owner.
| Name | Path | Type | Description |
|---|---|---|---|
|
ID
|
gid | string |
The ID of the project owner. |
|
name
|
name | string |
The name of the project owner. |
AssigneeV2
The user to whom this task is assigned.
| Name | Path | Type | Description |
|---|---|---|---|
|
ID
|
gid | string | |
|
name
|
name | string |
TargetV2
The task that this comment is associated with.
| Name | Path | Type | Description |
|---|---|---|---|
|
ID
|
gid | string |
The ID of the task that this comment is associated with. |
|
name
|
name | string |
The ID of the task that this comment is associated with. |
CreatedByV2
The user that authored this comment.
| Name | Path | Type | Description |
|---|---|---|---|
|
ID
|
gid | string |
The ID of the user that authored this comment. |
|
name
|
name | string |
The name of the user that authored this comment. |