> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Asana Personal Access Token Connector

## Intro

Asana's cloud-based project management platform helps organizations track their productivity. Domo brings your Asana projects into clearer focus by analyzing every piece of the process-users, tasks, and projects-so users can create reports, share the data with stakeholders, and get more done in less time.

The Asana Connector is a safe and quick data connection that you can use to measure success and progress of initiatives at your company. Get automated reports in just seconds. Domo pulls only the most pertinent data to create lightning fast Asana reports, so you're never making choices based on outdated information. Domo's easy-to-use platform encourages more productive collaboration. To learn more about the Asana API, visit their page ([https://asana.com/developers/documen...arted/overview](https://asana.com/developers/documentation/getting-started/overview "https://asana.com/developers/documentation/getting-started/overview") ).

You connect to your Asana account in the Data Center. This topic discusses the fields and menus that are specific to the Asana connector user interface. General information for adding DataSets, setting update schedules, and editing DataSet information is discussed in [Adding a DataSet Using a Data Connector](/s/article/360042926274).

## Prerequisites

To connect to your Asana account and create a DataSet, you must have the personal access token associated with your Asana account..

## Connecting to Your Asana Account

This section enumerates the options in the **Credentials** and **Details** panes in the Asana Connector page. The components of the other panes in this page, **Scheduling** and **Name & Describe Your DataSet,** are universal across most connector types and are discussed in greater length in [Adding a DataSet Using a Data Connector](/s/article/360042926274).

### Credentials Pane

This pane contains fields for entering credentials to connect to your Asana account. The following table describes what is needed for each field:

| Field                 | Description                             |
| --------------------- | --------------------------------------- |
| Personal Access Token | Enter your Asana personal access token. |

Once you have entered valid Asana credentials, you can use the same account any time you go to create a new Asana DataSet. You can manage Connector accounts in the

**Accounts**

tab in the Data Center. For more information about this tab, see

[Managing User Accounts for Connectors](/s/article/360042926054).

### Details Pane

This pane contains a primary **Reports** menu, along with various other menus which may or may not appear depending on the report type you select. If you select the "Tasks" report, a "Subreport" menu appears from which you may select a secondary report.

<table border="1" cellPadding="1" cellSpacing="1"><thead><tr><th colSpan="1" rowSpan="1"><p> Menu </p></th><th colSpan="1" rowSpan="1"><p> Description </p></th></tr></thead><tbody><tr><td colSpan="1" rowSpan="1"><p> Report </p></td><td colSpan="1" rowSpan="1"><p> Select the Asana report you want to run. The following reports are available: </p><table border="1" cellPadding="1" cellSpacing="1"><thead><tr><th colSpan="1" rowSpan="1"> Report </th><th colSpan="1" rowSpan="1"> Description </th></tr></thead><tbody><tr><td colSpan="1" rowSpan="1"> Attachments </td><td colSpan="1" rowSpan="1"> This report pulls your asana attachments for a specified workspace. </td></tr><tr><td colSpan="1" rowSpan="1"> Custom Fields </td><td colSpan="1" rowSpan="1"> This report pulls your asana custom fields for a specified workspace. </td></tr><tr><td colSpan="1" rowSpan="1"> Goals </td><td colSpan="1" rowSpan="1"> This gets detail Goals record for all Goals associated with the selected workspace. </td></tr><tr><td colSpan="1" rowSpan="1"> Parent Goals </td><td colSpan="1" rowSpan="1"> This gets detail Parent Goals records for all Goals associated to a selected workspace. </td></tr><tr><td colSpan="1" rowSpan="1"> Projects </td><td colSpan="1" rowSpan="1"> This report gets all projects in a workspace. </td></tr><tr><td colSpan="1" rowSpan="1"> Stories </td><td colSpan="1" rowSpan="1"> This report gets all stories in a workspace </td></tr><tr><td colSpan="1" rowSpan="1"> Subgoals </td><td colSpan="1" rowSpan="1"> This gets detail Subgoals records for all Goals associated to a selected workspace. </td></tr><tr><td colSpan="1" rowSpan="1"> Subtasks </td><td colSpan="1" rowSpan="1"> This report gets all subtasks in a workspace </td></tr><tr><td colSpan="1" rowSpan="1"> Supporting Work </td><td colSpan="1" rowSpan="1"> This gets detail Supporting Work records for all Goals associated to a selected workspace. </td></tr><tr><td colSpan="1" rowSpan="1"> Tags </td><td colSpan="1" rowSpan="1"> This report gets all tags made on all tasks in a workspace. </td></tr><tr><td colSpan="1" rowSpan="1"> Tasks </td><td colSpan="1" rowSpan="1"> This report gets all tasks in a workspace. </td></tr><tr><td colSpan="1" rowSpan="1"> Teams </td><td colSpan="1" rowSpan="1"> This report gets all teams in a workspace. </td></tr><tr><td colSpan="1" rowSpan="1"> Users </td><td colSpan="1" rowSpan="1"> This report gets all users on a workspace </td></tr><tr><td colSpan="1" rowSpan="1"> Workspaces </td><td colSpan="1" rowSpan="1"> This gets all workspaces for a client. </td></tr></tbody></table></td></tr><tr><td colSpan="1" rowSpan="1"><p> Subreport </p></td><td colSpan="1" rowSpan="1"><p> Select the desired subreport for the "Tasks" report. The following subreports are available: </p><table border="1" cellPadding="1" cellSpacing="1" className="mt-responsive-table"><tbody><tr><th colSpan="1" rowSpan="1"> Sub-report </th><th colSpan="1" rowSpan="1"> Description </th></tr><tr><td colSpan="1" rowSpan="1"> None </td><td colSpan="1" rowSpan="1"> This report gets all tasks in a workspace. </td></tr><tr><td colSpan="1" rowSpan="1"> Custom Fields </td><td colSpan="1" rowSpan="1"> This report gets all tasks in a workspace enhanced with custom fields data. </td></tr><tr><td colSpan="1" rowSpan="1"> Followers </td><td colSpan="1" rowSpan="1"> This report gets all tasks in a workspace enhanced with followers data. </td></tr><tr><td colSpan="1" rowSpan="1"> Hearts </td><td colSpan="1" rowSpan="1"> This report gets all tasks in a workspace enhanced with hearts data. </td></tr><tr><td colSpan="1" rowSpan="1"> Memberships </td><td colSpan="1" rowSpan="1"> This report gets all tasks in a workspace enhanced with memberships data. </td></tr><tr><td colSpan="1" rowSpan="1"> Projects </td><td colSpan="1" rowSpan="1"> This report gets all tasks in a workspace enhanced with task projects. </td></tr></tbody></table></td></tr><tr><td colSpan="1" rowSpan="1"> Workspace </td><td colSpan="1" rowSpan="1"> Select the workspace you want to retrieve data for. </td></tr></tbody></table>

### Other Panes

For information about the remaining sections of the connector interface, including how to configure scheduling, retry, and update options, see [Adding a DataSet Using a Data Connector](/s/article/360042926274).

## FAQ

<AccordionGroup>
  <Accordion title="What version of the Asana API does this connector use?">
    This connector uses version 1 of the Asana API ([https://app.asana.com/api/1.0](https://app.asana.com/api/1.0)).
  </Accordion>

  <Accordion title="Which endpoint(s) does each report call in this connector?">
    <table><tbody><tr><th colSpan="1" rowSpan="1"> Report Name </th><th colSpan="1" rowSpan="1"> Endpoint URL(s) </th></tr><tr><td colSpan="1" rowSpan="1"> Attachments </td><td colSpan="1" rowSpan="1"> /tasks/{'{task-id}'}/attachments </td></tr><tr><td colSpan="1" rowSpan="1"> Custom Fields </td><td colSpan="1" rowSpan="1"> /workspaces/{'{workspace-id}'}/custom\_fields </td></tr><tr><td colSpan="1" rowSpan="1"> Goals </td><td colSpan="1" rowSpan="1"> /goals/{'{id}'} </td></tr><tr><td colSpan="1" rowSpan="1"> Parent Goals </td><td colSpan="1" rowSpan="1"> /goals/{'{id}'}/parentgoals </td></tr><tr><td colSpan="1" rowSpan="1"> Projects </td><td colSpan="1" rowSpan="1"> /workspaces/{'{workspace-id}'}/users </td></tr><tr><td colSpan="1" rowSpan="1"> Stories </td><td colSpan="1" rowSpan="1"> /tasks/{'{task-id}'}/stories </td></tr><tr><td colSpan="1" rowSpan="1"> Subgoals </td><td colSpan="1" rowSpan="1"> /goals/{'{id}'}/subgoals </td></tr><tr><td colSpan="1" rowSpan="1"> Subtasks </td><td colSpan="1" rowSpan="1"> /tasks/{'{task-id}'}/subtasks </td></tr><tr><td colSpan="1" rowSpan="1"> Supporting Work </td><td colSpan="1" rowSpan="1"> /goals/{'{id}'}/supportingWork </td></tr><tr><td colSpan="1" rowSpan="1"> Tags </td><td colSpan="1" rowSpan="1"> /workspaces/{'{workspace-id}'}/tags </td></tr><tr><td colSpan="1" rowSpan="1"> Tasks </td><td colSpan="1" rowSpan="1"> /projects/{'{project-id}'}/tasks </td></tr><tr><td colSpan="1" rowSpan="1"> Teams </td><td colSpan="1" rowSpan="1"> /organizations/{'{organization-id}'}/teams </td></tr><tr><td colSpan="1" rowSpan="1"> Users </td><td colSpan="1" rowSpan="1"> /users </td></tr><tr><td colSpan="1" rowSpan="1"> Workspaces </td><td colSpan="1" rowSpan="1"> /workspaces </td></tr></tbody></table>
  </Accordion>

  <Accordion title="What kind of credentials do I need to power up this connector?">
    You need the personal access token associated with your Asana account.
  </Accordion>

  <Accordion title="Can I use the same account multiple times to create datasets?">
    Yes
  </Accordion>

  <Accordion title="How often can the data be updated?">
    Datasets can be updated as often as once an hour.
  </Accordion>

  <Accordion title="Are there any API limits that I need to be aware of?">
    No
  </Accordion>
</AccordionGroup>
