Asana Connector

Introduction

Asana is a comprehensive work management tool designed to help individuals and teams keep track of tasks, delegate responsibilities, monitor progress, and communicate in real-time. By providing a centralized platform for collaboration, Asana helps teams stay organized and focused, ensuring that projects are completed on time.

Purpose

With the help of Tulip - Asana connector you can effectively keep track of your Asana projects, tasks and workspaces in a Tulip application. Furthermore, you can modify any relevant task information, or even create new cards from a Tulip app.

API Doc

The following Connector Function highlighted in this document have leveraged Asana API Docs.

Pre-Requisites

1. Sign up for an account at Asana.com.

2. Decide which Authentication method suits you the best:

   1. Personal access token
   2. Service Account
   3. OAuth
   4. OpenID Connect

3. For this use case we prepared Personal access token, therefore generate a PAT at this link.

Tulip Connection Details

The following information would need to be configured on Tulip's HTTP connector.

Running On: Cloud Connector Host
Host: app.asana.com
Port: 443
TLS: Yes
Authentication: OAuth 2.0 (Bearer Token)
Prefix : Bearer
Token: Insert the personal access token that generated on the previous step.

Example Prebuilt Connector Functions

GET - List projects in a Workspace

Returns the compact project records for some filtered set of projects. Use one or more of the parameters provided to filter the projects returned.

GET - List workspaces

Returns the compact records for all workspaces visible to the authorized user.

GET - Multiple tasks by project ID

Returns the compact task records for all tasks within the given project, ordered by their priority within the project. Tasks can exist in more than one project at a time.

GET - Single project information

Returns the complete project record for a single project.

GET - Single task by ID

Returns the complete task record for a single task.

GET - Teams by user

Returns the compact records for all teams to which the given user is assigned.

POST - Create new task

Creating a new task is as easy as POSTing to the /tasks endpoint with a
data block containing the fields you’d like to set on the task. Any
unspecified fields will take on default values.

Every task is required to be created in a specific workspace, and this
workspace cannot be changed once set. The workspace need not be set
explicitly if you specify projects or a parent task instead.

PUT - Change tasks status to completed

A specific, existing task can be updated by making a PUT request on the
URL for that task. Only the fields provided in the data block will be
updated; any unspecified fields will remain unchanged.

When using this method, it is best to specify only those fields you wish
to change, or else you may overwrite changes made by another user since
you last retrieved the task.

Next Steps

• Learn more about Asana here.
• Learn more about connectors here