Asana

  • Reference

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

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.

This operation is used to add a comment to an existing task.
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.

This operation is used to mark an existing task as complete.
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.

This operation is used to create a new project.
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.

This operation is used to create a new task in your Asana project.
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.

This operation retrieves project object by Project ID.
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.

This operation retrieves a task object by Task ID.
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.

This operation retrieves user object by User ID.
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.

This operation is used to view teams in the workspace or organization.
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 retrieves the list of users for a given workspace.

Add Comment (V2)

Operation ID:
AddCommentV2

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]

Operation ID:
AddComment

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)

Operation ID:
CompleteTaskV2

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]

Operation ID:
CompleteTask

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)

Operation ID:
CreateProjectV2

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]

Operation ID:
CreateProject

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)

Operation ID:
CreateTaskV2

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]

Operation ID:
CreateTask

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)

Operation ID:
GetProjectV2

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]

Operation ID:
GetProject

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)

Operation ID:
GetTaskV2

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]

Operation ID:
GetTask

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)

Operation ID:
GetUserV2

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]

Operation ID:
GetUser

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)

Operation ID:
ListWorkspaceTeamsV2

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]

Operation ID:
ListWorkspaceTeams

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)

Operation ID:
ListUsersV2

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]

Operation ID:
ListUsers

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.

Triggers when a new project is created.
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.

Triggers when an existing task is completed.
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 task is created.

When a project is created (V2)

Operation ID:
OnProjectCreatedV2

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

Body
ListProjectsResponseV2

When a project is created [DEPRECATED]

Operation ID:
OnProjectCreated

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)

Operation ID:
OnTaskCompletedV2

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]

Operation ID:
OnTaskCompleted

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)

Operation ID:
OnTaskCreatedV2

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]

Operation ID:
OnTaskCreated

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