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 |
---|---|---|
Logic Apps | Standard | All Logic Apps regions except the following: - Azure Government regions - Azure China regions - 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) |
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) |
Connector Metadata | |
---|---|
Publisher | Microsoft |
Website | https://asana.com/ |
Privacy policy | https://asana.com/terms#privacy-policy |
Name | Calls | Renewal Period |
---|---|---|
API calls per connection | 30 | 60 seconds |
Frequency of trigger polls | 1 | 15 seconds |
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.
|
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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.
|
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
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
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
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
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
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
Name | Path | Type | Description |
---|---|---|---|
Projects
|
data | array of 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. |
Name | Path | Type | Description |
---|---|---|---|
Tasks
|
data | array of 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 |
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. |
Name | Path | Type | Description |
---|---|---|---|
data
|
data | array of object | |
Team ID
|
data.id | integer |
Globally unique ID of the team. |
Name | Path | Type | Description |
---|---|---|---|
Users
|
data | array of UserResponse |
An Asana user.
Name | Path | Type | Description |
---|---|---|---|
User ID
|
id | integer | |
User name
|
name | string | |
Email
|
string |
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. |
The workspace.
Name | Path | Type | Description |
---|---|---|---|
ID
|
id | integer | |
name
|
name | string |
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. |
The user to whom this task is assigned.
Name | Path | Type | Description |
---|---|---|---|
ID
|
id | integer | |
name
|
name | string |
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. |
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. |
Name | Path | Type | Description |
---|---|---|---|
Projects
|
data | array of 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. |
Name | Path | Type | Description |
---|---|---|---|
Tasks
|
data | array of 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 | |
Liked
|
hearted | boolean |
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. |
Name | Path | Type | Description |
---|---|---|---|
data
|
data | array of object | |
Team ID
|
data.gid | string |
Globally unique ID of the team. |
Name | Path | Type | Description |
---|---|---|---|
Users
|
data | array of UserResponseV2 |
An Asana user.
Name | Path | Type | Description |
---|---|---|---|
User ID
|
gid | string | |
User name
|
name | string | |
Email
|
string |
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. |
The workspace.
Name | Path | Type | Description |
---|---|---|---|
ID
|
gid | string | |
name
|
name | string |
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. |
The user to whom this task is assigned.
Name | Path | Type | Description |
---|---|---|---|
ID
|
gid | string | |
name
|
name | string |
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. |
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. |