Skip to main content
Version: 8.6

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

You can apply a Connector to a task or event via the append menu. For example:

  • 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

After you have applied a Connector to your element, follow the configuration steps or see 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.