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

# Asana

> Connect BonData to Asana to sync projects, tasks, and team data

Asana is a work management platform teams use to organize, track, and manage projects, tasks, and workflows. With BonData, you can connect to your Asana account to read, enrich, and sync your work management data within Agent workflows.

## Asana Personal Access Token Setup

Follow these steps to get your Asana credentials for BonData.

### Step 1: Open Your Developer Settings

1. Log in to [Asana](https://app.asana.com/)
2. Click your profile photo in the top-right corner and select **Settings**
3. Open the **Apps** tab
4. Click **Manage Developer Apps**

### Step 2: Create a Personal Access Token

1. On the developer console, find the **Personal access tokens** section
2. Click **Create new token**
3. Give the token a descriptive name (e.g., `BonData Integration`)
4. Read and agree to the API terms
5. Click **Create token**
6. **Copy the token immediately** - it is only shown once

<Note>
  Personal access tokens inherit the permissions of the user who created them. To sync a specific workspace, make sure that user is a member of it.
</Note>

### Step 3: Enter Credentials in BonData

1. In BonData, navigate to **Integrations** and select **Asana**
2. Enter your **Personal Access Token**
3. Click **Connect**

## Required Fields

| Field                 | Description                                                     |
| --------------------- | --------------------------------------------------------------- |
| Personal Access Token | Token generated from Asana developer console (My Access Tokens) |

## Available Data

Once connected, BonData can sync the following Asana objects:

* **Projects** - Projects with owners, status, and custom fields
* **Tasks** - Tasks with assignees, due dates, dependencies, and completion state
* **Sections** - Sections that group tasks within a project or board
* **Users** - Workspace members and their profile details
* **Teams** - Teams and their membership within an organization
* **Tags** - Tags used to categorize tasks across projects
* **Stories** - Comments and activity history on tasks
* **Portfolios** - Portfolios that roll up projects for reporting
