Asana

Manage tasks, projects, and workspaces with the Asana API.

Detail	Value
Category	Project Management
Base URL	https://app.asana.com/api/1.0
Authentication	Bearer Token
Endpoints	6
Connector key	asana

Using Asana in a workflow

1. Go to Connections and click New Connection.
2. Pick Asana from the marketplace.
3. Enter your credentials (see Authentication above for what's expected).
4. In a workflow, drop an API Call node and select this connection.
5. Pick the operation you need from the Operation dropdown. The full list is below.

Available endpoints

Endpoint	Summary
GET /tasks	List tasks in a project
POST /tasks	Create a task
GET /tasks/{task_gid}	Get a task
PUT /tasks/{task_gid}	Update a task
GET /projects	List projects in a workspace
GET /workspaces	List all workspaces

Each endpoint is documented in full below. Use the outline on the right to jump to one.

GET /tasks

List tasks in a project

Detail	Value
Operation ID	pm.listTasks
Method	GET
Path	/tasks

Parameters

Name	Location	Type	Required
project	query	string	Yes
opt_fields	query	string	No

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your Asana connection from the Connection dropdown.
3. In the Operation dropdown, select pm.listTasks.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked: fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Asana API reference.

POST /tasks

Create a task

Detail	Value
Operation ID	pm.createTask
Method	POST
Path	/tasks

Parameters

No parameters.

Request Body

Field	Type
data	object

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your Asana connection from the Connection dropdown.
3. In the Operation dropdown, select pm.createTask.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked: fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Asana API reference.

GET /tasks/{task_gid}

Get a task

Detail	Value
Operation ID	pm.getTask
Method	GET
Path	/tasks/{task_gid}

Parameters

Name	Location	Type	Required
task_gid	path	string	Yes

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your Asana connection from the Connection dropdown.
3. In the Operation dropdown, select pm.getTask.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked: fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Asana API reference.

PUT /tasks/{task_gid}

Update a task

Detail	Value
Operation ID	pm.updateTask
Method	PUT
Path	/tasks/{task_gid}

Parameters

Name	Location	Type	Required
task_gid	path	string	Yes

Request Body

Field	Type
data	object

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your Asana connection from the Connection dropdown.
3. In the Operation dropdown, select pm.updateTask.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked: fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Asana API reference.

GET /projects

List projects in a workspace

Detail	Value
Operation ID	pm.listProjects
Method	GET
Path	/projects

Parameters

Name	Location	Type	Required
workspace	query	string	Yes

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your Asana connection from the Connection dropdown.
3. In the Operation dropdown, select pm.listProjects.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked: fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Asana API reference.

GET /workspaces

List all workspaces

Detail	Value
Operation ID	pm.listWorkspaces
Method	GET
Path	/workspaces

Parameters

No parameters.

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your Asana connection from the Connection dropdown.
3. In the Operation dropdown, select pm.listWorkspaces.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Asana API reference.