Skip to main content
Version: Next

Asana Connector

The Asana Connector is an outbound protocol Connector that allows you to connect your BPMN service with Asana to get and create Asana tasks and projects.

Prerequisites

To use the Asana Connector, you must have an Asana personal access token.

note

Use Camunda secrets to avoid exposing your Asana personal access token as plain text. Refer to our documentation on managing secrets to learn more.

Create an Asana Connector task

A Connector can be applied to a task or an event using the append menu. Access the append menu using any of the three methods below:

  • From the canvas: Select an element and click the Change element icon to change an existing element, or use the append feature to add a new element to the diagram.
  • From the properties panel: Navigate to the Template section and click Select.
  • From the side palette: Click the Create element icon.

change element

Once you have applied a Connector to your element, follow the configuration steps or read our guide on using Connectors to learn more.

Authentication

In the Authentication section, provide a Personal access token. Read more on how to obtain it.

Select operation to execute

Tasks

Get tasks from a project

Get a task by ID

  • Asana API: Get a task.
  • Task ID: The task to operate on.

Create a task

  • Asana API: Create a task.
  • Task name: The name of the task.
  • Project ID: Globally unique identifier for the project.
  • Parent task ID: Globally unique identifier for the parent task.
  • Notes: Free-form textual information associated with the task (i.e. its description).

Delete a task

Projects

Get projects

  • Asana API: Get multiple projects.
  • Workspace ID: The workspace or organization to filter projects on.
  • Team ID: The team to filter projects on.

Get a project by ID

  • Asana API: Get a project.
  • Project ID: Globally unique identifier for the project.

Create a project in a workspace

  • Asana API: Create a project in a workspace.
  • Workspace ID: Globally unique identifier for the workspace or organization.
  • Project name: Name of the project. This is generally a short sentence fragment that fits on a line in the UI for maximum readability. However, it can be longer.
  • Project note: Free-form textual information associated with the project (ie., its description).

Delete a project

  • Asana API: Delete a project.
  • Project ID: Globally unique identifier for the project.

Handle Connector response

The Asana Connector is a protocol Connector, meaning it is built on top of the HTTP REST Connector. Therefore, handling response is still applicable as described.