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

# Asana

> How to connect Asana to Pike, sync Asana tasks into Pike tasks in real time, or import Asana projects once to move off Asana.

The Asana integration syncs Asana tasks into Pike tasks in real time, or copies Asana projects into Pike once when you move off Asana. Teams that plan in Asana keep doing so, while Pike tracks time, budgets, and margin on the same work.

## Connect Asana

1. Go to **Workspace settings** → **Integrations** → **Asana**.
2. Click **Add integration**.
3. Authorize Pike for your Asana workspace in the popup.
4. On the integration page, map each Asana project to a Pike project.

Only workspace admins can connect or disconnect Asana.

## Import data

On the integration page, click **Import data**. The stepper runs entities in dependency order, so tasks import before their subtasks. It skips entities whose **Read** toggle is off, names them, and links to sync settings.

## What syncs

Asana tasks become Pike tasks.

| Asana | Pike | Notes |
| - | - | - |
| Task name | Task title | |
| Notes | Task description | |
| Assignee | Assignee | Matched by email |
| Due date | Due date | |
| Subtasks | Subtasks | |
| Tags | Labels | |
| Section | Task status | Through an editable status mapping |
| Completed task | Done | |

### Import once

To move off Asana, choose **Import once**. It copies projects, sections, tasks, subtasks, and comments as text, then disconnects.

### Source of truth

Once a record is linked, Asana, while ongoing sync is on, owns the linked fields and Pike reads them back. Pike-only fields, such as project links, internal notes, allocations, and cost profiles, stay in Pike and are never overwritten.

### Schedule

Changes in Asana reach Pike in real time through Asana webhooks. **Import data** and **Refresh** always run on demand.

## Sync settings

While Asana is connected, the **What syncs with Asana** card sits under the top button row on the integration page. Each entity has a **Read** toggle (Asana to Pike). Toggles save immediately.

| Entity | Read | Send |
| - | - | - |
| Tasks | Yes | Not available |

New connections start with **Read** on for everything.

## Synced records

Every synced record shows the Asana marker, "Last synced {time}" or "Not synced yet", and a **Refresh** action. **Refresh** shows only while **Read** is on for that entity.

### Sync issues

Records that fail to sync appear in the **Sync issues** list on the integration page, with the record, the reason, and a **Retry** action. The integration never deletes Pike data on its own. A record removed in Asana is marked "Removed in Asana" in Pike, never deleted.

## Disconnect

Disconnecting Asana stops syncing and keeps all imported data. Linked records keep their history.

## Permissions

Synced data respects Pike roles and private projects. A private project's tasks never sync out to anyone who cannot see the project in Pike.

## Limits

* Pike does not write back to Asana.
* Attachments import as links, not files.
* Asana custom fields do not sync.

## Related

* [Asana integration overview](https://usepike.com/integrations/asana): What syncs, how agencies use it, and FAQs.
* [Jira](https://usepike.com/docs/integrations/jira.md): Sync Jira issues and send worklogs.
* [Linear](https://usepike.com/docs/integrations/linear.md): Sync Linear issues into Pike tasks.
* [CSV](https://usepike.com/docs/integrations/csv.md): Import tasks from any tool by file.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.