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

# Connect your app to Asana

> Connect your app to Asana with a personal access token (PAT) to create and update tasks, read project and team data, and automate work tracking workflows in your Lovable apps.

export const connector_0 = "Asana"

[Asana](https://asana.com/) is a work management platform for tasks, projects, and team planning. It lets your Lovable app work with tasks, projects, teams, sections, and assignees so you can build internal tools and automations that interact directly with your team's Asana workspace.

With Asana, your app can:

* Create and update tasks
* Read team, project, and section data
* Track assignees, due dates, and task status
* Automate intake, reporting, and planning workflows

Asana is a good fit when your app needs to work with project management, task tracking, or team planning directly from your app interface.

## Common use cases and example apps

| Example app               | Example prompt                                                                                                                     | Description                                                                                                                                                                                                     |
| :------------------------ | :--------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Request intake to Asana   | *Build an intake form. When someone submits, create an Asana task in the Operations project and assign it to the on-call manager.* | **Turn form submissions into trackable Asana tasks automatically.** <br />The app captures the submission and creates a properly formatted Asana task in the right project, with no manual copy-paste required. |
| Project status dashboard  | *Build a dashboard that reads tasks from our Launch project, groups by section, and highlights overdue items.*                     | **Give teams a live project view without leaving your app.** <br />The app reads current project data from Asana and displays tasks by section, assignee, or status.                                            |
| Automated task follow-ups | *Every weekday, find incomplete tasks due in 2 days and post a reminder summary in the app.*                                       | **Reduce missed deadlines with automated follow-up logic.** <br />The app reads upcoming due dates from Asana and surfaces reminders directly in your app.                                                      |
| Team workload view        | *Show open tasks by assignee from Asana and flag teammates with more than 10 active tasks.*                                        | **Surface workload imbalance for planning and staffing decisions.** <br />The app reads task assignments from Asana and organizes them into a focused workload view.                                            |
| Bug-to-task workflow      | *When a bug report is submitted, create an Asana task with severity, reporter, and reproduction steps.*                            | **Standardize triage by routing bug reports into Asana with structure.** <br />The app turns incoming bug reports into properly formatted Asana tasks so nothing falls through the cracks.                      |

## How Asana connections work

Each Asana connection is authenticated with a personal access token (PAT) issued by an Asana account. When you connect Asana, you authorize Lovable to call Asana on behalf of the account that issued the PAT.

Within your Lovable workspace:

* You can create multiple Asana connections.
* Each connection uses a separate PAT.
* Each connection can:
  * Be tied to a different Asana account
  * Access different Asana workspaces or projects, depending on the PAT's permissions
* Multiple projects within a single workspace can use the same connection.

This makes it easy to separate environments (for example, development and production) or manage multiple Asana accounts.

The connection can only access data that the Asana account behind the PAT can access. If you revoke or rotate the PAT in Asana, the connection stops working until you update the token and reconnect.

## How to connect Asana

Workspace **admins** and **owners** can connect Asana.

### Prerequisites

Before connecting Asana, make sure you have:

* An Asana account
* An Asana personal access token (PAT)
* Lovable workspace admin or owner role

### Set up your Asana connection

<Steps>
  <Step title="Navigate to the Asana connector">
    Open **Connectors** → **App connectors** and select **Asana**.
  </Step>

  <Step title="Add a new connection">
    Click **Add connection**.
  </Step>

  <Step title="Name the connection">
    In **Display name**, enter a name for the connection, for example `Asana (Prod)`.
  </Step>

  <Step title="Add your personal access token">
    In **Personal access token**, paste your Asana PAT (for example, `1/xxxxxxxx...`), or click **Get value** to open Asana and generate one.

    <Tip>
      The PAT inherits the permissions of the Asana account that issued it. Make sure that account has access to the workspaces and projects your app needs.
    </Tip>
  </Step>

  <Step title="Choose who can access this connection">
    Under **Who can access this connection**, keep access limited to specific people, or choose **Invite entire workspace**.
  </Step>

  <Step title="Connect">
    Click **Connect**. The connection appears as enabled in **Connectors** → **App connectors** → **Asana**.
  </Step>
</Steps>

When connected, your Lovable apps can start using Asana data.

## Limitations

The Asana connector does not support:

* Receiving incoming Asana webhooks or real-time event subscriptions.
* Per-user Asana login where each end user connects their own Asana account.
* Access to Asana data outside the permissions of the account that issued the PAT.

## How to unlink projects from a {connector_0} connection

Editors and above can remove specific projects from a connection without deleting the connection entirely. The connection will remain available for other projects.

To unlink projects:

<Steps>
  <Step title="Open Connectors">
    Open **Connectors**, then go to **App connectors**, and select **{connector_0}**.
  </Step>

  <Step title="Open the connection">
    Open the connection you want to manage.
  </Step>

  <Step title="Select projects">
    Under **Linked projects**, check the projects you want to unlink.
  </Step>

  <Step title="Confirm">
    Click **Unlink projects** and confirm.
  </Step>
</Steps>

When unlinked, those projects will no longer have access to {connector_0} through this connection. If a project needs {connector_0} again, you can link it to any available connection.

## How to delete a {connector_0} connection

Workspace admins and owners can delete {connector_0} connections.

<Warning>
  Deleting a connection is permanent and cannot be undone. It will remove the credentials from all linked projects, and any apps using this connection will stop working until a new connection is added.
</Warning>

Before deleting, review the **Linked projects** section to see which projects are currently using the connection.

To delete a connection:

<Steps>
  <Step title="Open Connectors">
    Open **Connectors**, then go to **App connectors**, and select **{connector_0}**.
  </Step>

  <Step title="Open the connection">
    Open the connection you want to remove.
  </Step>

  <Step title="Review linked projects">
    Review the **Linked projects** section.
  </Step>

  <Step title="Delete">
    Under **Delete this connection**, click **Delete** and confirm.
  </Step>
</Steps>