> ## 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 Connector ## Intro Asana is a cloud-based project management platform that helps users track projects, tasks, stories, and other project-related workflows. 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 "Adding a DataSet Using a Data Connector"). ## Prerequisites To connect to your Asana account and create a DataSet, you must have the email address you use to log into Asana, as well as your Asana password. Alternatively, you can use Google credentials to connect. ## 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 "Adding a DataSet Using a Data Connector"). ## Credentials Pane The Domo Asana connector uses OAuth to connect, so there is no need to enter credentials within Domo. Click **Connect** (or select **Add Account** if you have existing Asana accounts in Domo) to open the Asana OAuth screen where you can enter your Asana or Google credentials. Once you have entered valid 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 "Managing User Accounts for Connectors"). **Note:** If you are already logged into Asana when you connect in Domo, you are authenticated automatically when you click **Add account**. If you want to connect to an account that is different from the one you are logged into, you must first log out of Asana. You will also need an API Key for your Asana account. Any user can get their own API key by visiting the Account Settings dialog and clicking on the Apps tab. The API key is located at the bottom of this dialog box. ## 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.

Menu

Description

Report

Select the Asana report you want to run. The following reports are available:

Attachments This report pulls your asana attachments for a specified workspace.
Custom Fields This report pulls your asana custom fields for a specified workspace.
Projects This report gets all projects in a workspace.
Stories This report gets all stories in a workspace.
Subtasks This report gets all subtasks in a workspace.
Subtasks For Team This report gets all subtasks for selected team in a workspace.
Tags This report gets all tags made on all tasks in a workspace.
Tasks This report gets all tasks in a workspace.
Teams This report gets all teams in a workspace.

Time Tracking Entries

This report returns time tracking entries for a task.
Users This report gets all users on a workspace.
Workspaces This report gets all workspaces for a client.
Subreport

The following subreports are available:

Subreport Description
Custom Fields This report gets all tasks in a workspace enhanced with custom fields data.
Custom Field Settings Returns array of Custom Field Settings data.
Followers This report gets all tasks in a workspace enhanced with followers data.
Hearts This report gets all tasks in a workspace enhanced with hearts data.
Memberships This report gets all tasks in a workspace enhanced with memberships data.
None This report gets all tasks in a workspace.
Projects This report gets all tasks in a workspace enhanced with task projects.
Tags This report gets all tasks in a workspace enhanced with tags data.
Action on 403 Error Select the action to perform when request to fetch subtasks for particular task id is failed with 403 (no access error). Skip failed record and continue will skip failed task and continue with remaining tasks.
Workspace Select the workspace you want to retrieve data for.
Tasks Completed Since (optional) Select the date to return tasks that are either incomplete or those which have been completed till this date. ( Note: For reports Subtasks and Subtaks For Team , it will bring subtasks for the tasks which are incomplete or completed since this date.)
Use Extended Run (checkbox) Select the checkbox if you have large amounts of data, which will take more than 24 hours to import. Connector runs that take more than 24 hours may be canceled. The Extended Run functionality allows the connector to import as much data as possible during each 24 hour block, and resume the data import without user intervention in the next available 24 hour block.
Exclude Nested Subtasks (checkbox) Select the checkbox if you don't want to import subtasks that are nested under other subtasks.
Action On 403 Error The connector will fail with an error message as 403 - No Access , if the user running the connector does not have access to the details of a task in the task list. You have the option where the connector can ignore these errors and continue, by selecting Skip failed record and continue . If you want the connector to fail when a 403 error occurs, the you can select the Throw Exception option. The default behavior is to Throw Exception .
## 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 "Adding a DataSet Using a Data Connector"). ## FAQ DataSets can be updated as often as once an hour. Asana does not document any limits in their API.