> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rootly.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Install and configure the Rootly Asana integration to automatically create and update tasks from incidents and action items in your Asana workspace.

## Introduction

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

<Callout icon="user-shield" color="#DBEAFE">
  We recommend installing with a dedicated Asana service account so the integration does not break if an individual user leaves your organization.
</Callout>

## Installation

<Steps>
  <Step title="Open the Asana integration in Rootly" icon="plug">
    Navigate to the integrations page in Rootly and select **Asana**.

    <Frame>
      <img alt="Document Image" src="https://mintcdn.com/rootly/yHcXrOapKHrppc-2/images/integrations/asana/installation/installation-1.webp?fit=max&auto=format&n=yHcXrOapKHrppc-2&q=85&s=51d16a4f4af07125ef54411a19bd0b1c" width="868" height="393" data-path="images/integrations/asana/installation/installation-1.webp" />
    </Frame>
  </Step>

  <Step title="Authorize Rootly with Asana" icon="key">
    You will be redirected to Asana to sign in and grant Rootly permission to access your workspace. Once authorized, the installation is complete.

    <Frame>
      <img alt="Document Image" src="https://mintcdn.com/rootly/yHcXrOapKHrppc-2/images/integrations/asana/installation/installation-2.webp?fit=max&auto=format&n=yHcXrOapKHrppc-2&q=85&s=c93326552eafde3861b9829c82721704" width="871" height="682" data-path="images/integrations/asana/installation/installation-2.webp" />
    </Frame>

    <Callout icon="circle-check" color="#DCFCE7">
      After authorization, the **Create an Asana Task**, **Create an Asana Subtask**, and **Update an Asana Task** workflow actions are available in your Genius workflows.
    </Callout>
  </Step>
</Steps>

## Uninstall

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