Partilhar via


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

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)

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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

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

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

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

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)

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

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

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

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

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

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.