Skip to main content
The Asana integration connects Rootly with your Asana workspace so teams can automatically create and update tasks through Genius workflows. Tasks can be assigned, linked to projects, given due dates, and populated with custom fields — all driven by incident data. With the Asana integration, you can:
  • Automatically create Asana tasks when incidents are declared or reach a certain state
  • Create subtasks under an existing Asana task to track action items
  • Update task title, completion status, assignee, and custom fields as incidents evolve
  • Set task dependencies to model blocking relationships between tasks

​
Before You Begin

Before setting up the integration, make sure you have:
  • A Rootly account with admin permission to manage integrations
  • An Asana account with access to the workspace you want to use
Rootly recommends installing with a dedicated Asana service account so the integration does not break if an individual user leaves your organization.

​
Installation

Open the Asana integration in Rootly

Navigate to the integrations page in Rootly and select Asana.
Asana integration on the Rootly integrations page

Authorize Rootly with Asana

You will be redirected to Asana to sign in and grant Rootly permission to access your workspace. Once authorized, the installation is complete.
Asana authorization prompt granting Rootly workspace access
After authorization, the Create an Asana Task, Create an Asana Subtask, and Update an Asana Task workflow actions are available in your Genius workflows.

​
Workflow Actions

The Asana integration provides three workflow actions for managing tasks directly from Rootly incidents. If you are unfamiliar with how Genius workflows work, visit the Workflows documentation first.

​
Create an Asana Task

This action creates a new task in a specified Asana project.
Create an Asana Task workflow action configuration form
Use the Incident Variable Explorer to preview what Liquid variables return for your incidents.

​
Create an Asana Subtask

This action creates a subtask under an existing Asana task.
When a Create an Asana Task action runs, Rootly stores the resulting task ID on the incident record. Reference it in subsequent subtask actions using Liquid variables.
Create an Asana Subtask workflow action configuration form

​
Update an Asana Task

This action updates an existing Asana task with new values.
Update an Asana Task workflow action configuration form

​
Custom Fields

Use the Custom Fields Mapping field to set Asana custom field values using a JSON object. The key is the Asana custom field ID and the value depends on the field type. Text fields
Liquid syntax in text fields
Single-select enum fields — use the Asana enum option ID as the value:
Multi-select enum fields — use an array of enum option IDs:
Conditional enum mapping with Liquid
To find custom field IDs and enum option IDs, use the Asana API or inspect the URL when editing a custom field in Asana.

​
Uninstall

To remove the Asana integration, open the integrations panel in Rootly and select Configure > Delete.