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

# Asana

> Learn how to use Tunnel with Asana

## Overview

The Asana integration allows you to create issues in Asana from Tunnel comments. You can also set default issue properties and automatically create issues in Asana with every comment.

## Configuration

You can configure the Asana integration in the [Tunnel Dashboard](https://tunnel.dev/redirect-to/default) by navigating to **Settings > Profile** and scrolling to the **Integrations** section.

### Connect Asana

Go to the [Tunnel Dashboard](https://tunnel.dev/settings/integrations). Click **Connect** to connect your Asana organization.

<Frame>
  <img src="https://mintcdn.com/tunnel-19/HHvo6FC8pp1jesAt/assets/screenshots/integrations/asana/organization-settings.png?fit=max&auto=format&n=HHvo6FC8pp1jesAt&q=85&s=14410c776a453f6edba3528acbd9c68a" width="1719" height="1098" data-path="assets/screenshots/integrations/asana/organization-settings.png" />
</Frame>

## Create issues

### Manually

With your Asana account connected, you can create issues in Asana from Tunnel comments.

<Steps>
  <Step title="Open the integrations dropdown menu">
    To attach a Asana issue to a comment, open the integrations dropdown menu from the **Create** button. Select **Create issue** in the Asana row.

    <Frame>
      <img src="https://mintcdn.com/tunnel-19/HHvo6FC8pp1jesAt/assets/screenshots/integrations/integrations-dropdown.png?fit=max&auto=format&n=HHvo6FC8pp1jesAt&q=85&s=2d682da0586543be7bb2655b57f6ac98" width="417" height="186" data-path="assets/screenshots/integrations/integrations-dropdown.png" />
    </Frame>
  </Step>

  <Step title="Set issue properties">
    Set the team, project, status, labels, assignee, and priority for the issue.

    <Frame>
      <img src="https://mintcdn.com/tunnel-19/HHvo6FC8pp1jesAt/assets/screenshots/integrations/asana/asana-ticket-properties.png?fit=max&auto=format&n=HHvo6FC8pp1jesAt&q=85&s=ba6587256447f2a2129833ec7c8328a1" width="1716" height="1179" data-path="assets/screenshots/integrations/asana/asana-ticket-properties.png" />
    </Frame>
  </Step>

  <Step title="Submit the comment to create the issue">
    When you submit the comment, the issue will be created in Asana and a link to the issue will be added to the comment.

    <Frame>
      <img src="https://mintcdn.com/tunnel-19/HHvo6FC8pp1jesAt/assets/screenshots/integrations/asana/asana-ticket.png?fit=max&auto=format&n=HHvo6FC8pp1jesAt&q=85&s=84d5efd07a02ed37b4b0e88918fb7b49" width="1715" height="1133" data-path="assets/screenshots/integrations/asana/asana-ticket.png" />
    </Frame>
  </Step>
</Steps>

### Automatically

You can also set default issue properties and automatically create issues in Asana with every comment.

<Steps>
  <Step title="Add default issue properties">
    Go to the [Tunnel Dashboard](https://tunnel.dev/redirect-to/default) and navigate to **Settings > Profile**. Scroll to the **Integrations** section and click **Manage** in the **Asana** row.

    From here, you can set a default Asana team, and then set default values for project, status, assignee, and priority. You can also set default labels.

    <Frame>
      <img src="https://mintcdn.com/tunnel-19/HHvo6FC8pp1jesAt/assets/screenshots/integrations/asana/default-settings.png?fit=max&auto=format&n=HHvo6FC8pp1jesAt&q=85&s=126e9d9e4ff4a7f05cd5f95b066fe315" width="1716" height="1109" data-path="assets/screenshots/integrations/asana/default-settings.png" />
    </Frame>
  </Step>

  <Step title="(Optional) Turn on automatic issue creation">
    In your default Asana settings, you also have the option to turn on automatic issue creation. This will create a new issue in Asana for every you create comment in Tunnel.

    <Frame>
      <img src="https://mintcdn.com/tunnel-19/HHvo6FC8pp1jesAt/assets/screenshots/integrations/asana/automatic-screenshot-creation.png?fit=max&auto=format&n=HHvo6FC8pp1jesAt&q=85&s=660d6f7ffd8e860504e02ef3e46c1865" width="1718" height="1128" data-path="assets/screenshots/integrations/asana/automatic-screenshot-creation.png" />
    </Frame>
  </Step>

  <Step title="Create an issue">
    With your default settings configured, you can easily create an issue in Asana from a comment. To attach a Asana issue to a comment, open the integrations dropdown menu from the **Create** button. Select **Create issue** in the Asana row.

    <Frame>
      <img src="https://mintcdn.com/tunnel-19/HHvo6FC8pp1jesAt/assets/screenshots/integrations/integrations-dropdown.png?fit=max&auto=format&n=HHvo6FC8pp1jesAt&q=85&s=2d682da0586543be7bb2655b57f6ac98" width="417" height="186" data-path="assets/screenshots/integrations/integrations-dropdown.png" />
    </Frame>

    When you submit the comment, the issue will be created in Asana with your default settings and a link to the issue will be added to the comment.

    <Frame>
      <img src="https://mintcdn.com/tunnel-19/HHvo6FC8pp1jesAt/assets/screenshots/integrations/asana/asana-ticket.png?fit=max&auto=format&n=HHvo6FC8pp1jesAt&q=85&s=84d5efd07a02ed37b4b0e88918fb7b49" width="1715" height="1133" data-path="assets/screenshots/integrations/asana/asana-ticket.png" />
    </Frame>
  </Step>
</Steps>
