# Asana

*📋 Setting up automated task creation in Asana*

## Introduction <a href="#introduction" id="introduction"></a>

This one-time setup *per workspace* allows everyone in your Aikido organization to create issues directly in Asana.

Following use cases are supported :

* **Automated Ticket Creation**: Automatically create and push tickets to specified Asana projects for seamless tracking of security issues.
* **Manual Ticket Addition**: Manually add security issue tickets to Asana, ensuring targeted attention for critical vulnerabilities.

## Connecting the Aikido App to Asana <a href="#connecting-the-aikido-app-to-asana" id="connecting-the-aikido-app-to-asana"></a>

1. Navigate to [Integration Settings](https://app.aikido.dev/settings/integrations) within the Aikido app.
2. In the 'Task Trackers' section, select 'Asana'
3. A prompt will request authorization for Asana.

   ![Asana integration unauthorized; prompt to authorize access for issue-tracking.](/files/pcf8ILgUDhsyopGshTSp)

   ​
4. Login into your Asana account
5. Grant Aikido permission to access your Asana workspace

   ![Asana permission request for Aikido Security to access and modify your account data.](/files/5Y7BJuEdoVEH80mhAdzc)
6. Once authorized, Aikido is successfully connected to Asana, enhancing your task management capabilities 🚀

![Configure Asana integration to map repositories and enable automatic task creation.](/files/uZJjKybVuWPr42J7bHsj)

## ​Options for Task Creation in Asana via Aikido <a href="#options-for-task-creation-in-asana-via-aikido" id="options-for-task-creation-in-asana-via-aikido"></a>

There are two different options to create new tasks from Aikido into Asana.

1. Manually create tasks from the Aikido interface
2. Automatically create new tasks via Aikido's auto creation functionality.

## 1. Manual Task Creation <a href="#id-1-manual-task-creation" id="id-1-manual-task-creation"></a>

1. Hover over any issue in your feed and click the ***+*** in the **assignee column.**\
   ​

   ![Task assignee section with add and options buttons visible.](/files/qHdYxduZ8eHuhsF9A0fa)

   Alternatively, you can click the triple dots in the last columns to open up the action menu. If you have grouped issues, the triple dot action menu is available on every subissue.

   ![Action menu with options to manage, snooze, ignore, share, or adjust task severity.](/files/Cxt8PY3L6Dcjjd8FAiuN)

   ​
2. Fill in the required details in the popup modal.\
   ​

   ![Create a ClickUp task reporting a high-severity XSS vulnerability with details and link.](/files/FSBd55gWZvzrcZDTrRLJ)
3. The newly created task in Asana will be linked in the Aikido Issue Detail under the 'Tasks' tab (sidepanel).

![High-priority task warning: Unescaped input may cause XSS attacks.](/files/O7KizEctPUMALLWJ5GdF)

## 2. Automated Task Creation <a href="#id-2-automated-task-creation" id="id-2-automated-task-creation"></a>

{% hint style="info" %}
Aikido will automatically create tasks **every hour in bulk.** There is at the moment no option to trigger this manually.
{% endhint %}

1. Go to the [Asana Integration](https://app.aikido.dev/settings/integrations/tasktracker) settings
2. Make sure to enable '**Autocreation**' by clicking the toggle to **On.**
3. Define the criteria for automatic task creation.\
   ​

   ![Task autocreation settings for critical issues, limited to one task per day.](/files/h59Ti0iClc0WP9P8pmF2)

   ​
4. Aikido will then autonomously generate Asana tickets based on these settings 🚀


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.aikido.dev/getting-started/task-management-systems/all-supported-task-trackers/asana.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
