> ## Documentation Index > Fetch the complete documentation index at: https://domoinc-bradley-turek-pfilter-operators-reference.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.
Goals This report pulls your asana custom fields for a specified workspace. It is available only with Asana Advanced, Enterprise, Enterprise+, Legacy Business, and Legacy Enterprise plans.
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.
Workspace Select the workspace you want to retrieve data for.
Tasks Completed Since 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.
Disable 404 error warnings Select this option to disable 404 error warnings.
Action On 403 Error Select how to handle a 403 error. You can skip failed records and continue processing, or throw an exception.

Select the action to perform if a request to fetch subtasks for a specific task ID fails with a 403 - No Access error (which occurs if the user running the connector lacks permission to view a task's details).

Skip failed record and continue: The connector will ignore the 403 error, skip the inaccessible task, and continue processing the remaining tasks in the list.

Throw Exception: The connector will immediately stop execution and fail with a 403 error if an inaccessible task is encountered. (Default behavior)
Team Select the team.
## 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.