Integrated Data
Asana
What this page covers: A complete reference mapping every Asana field to its Mosaic equivalent. Use this guide when configuring your integration, verifying synced data, or troubleshooting discrepancies.
| Integration type | Cloud (Asana REST API) |
| Setup complexity | Low |
| Prerequisite | Asana Integration Setup |
How Data Flows
Asana (Asana REST API) → Mosaic Sync Engine (field mapping) → Mosaic (5 synced data types)
Mosaic pulls data from Asana using the Asana REST API. Teams, projects, sections, milestones, and tasks are mapped into Mosaic's project hierarchy.
Integrated Data Types
The integration syncs 5 data categories from Asana into Mosaic:
| # | Data Type | Description |
|---|---|---|
| 1 | Employees | Asana team members mapped to Mosaic employees |
| 2 | Projects | Asana projects with names, IDs, notes, and dates |
| 3 | Phases | Asana sections mapped as project phases |
| 4 | Milestones | Asana milestone tasks mapped as Mosaic milestones |
| 5 | Tasks | Asana tasks with descriptions, assignees, dates, and completion status |
This list may expand as new features are added.
Reading the Field Mapping Tables
Symbol legend for technical tables
The Technical Reference tabs below use a shorthand notation for API sources. Read this legend before reviewing the mappings.
| Symbol | Meaning | Example |
|---|---|---|
. | API object field reference | Project.name = the name field from the Project object |
Detailed Field Mappings
Jump to a section: Employees | Projects | Phases | Milestones | Tasks
Employees
| What Syncs to Mosaic | Where It Comes From in Asana |
|---|---|
| Employee Name | The team member's name (from Teams → Team Settings → Members) |
| Employee Email | The team member's email address |
Projects
| What Syncs to Mosaic | Where It Comes From in Asana |
|---|---|
| Project Title | The Asana project name |
| Project Number | The Asana project ID |
| Project Description | The Asana project notes |
| Start Date | The project start date |
| End Date | The project due date |
Phases
| What Syncs to Mosaic | Where It Comes From in Asana |
|---|---|
| Phase Name | The Asana section name within a project |
Milestones
| What Syncs to Mosaic | Where It Comes From in Asana |
|---|---|
| Milestone Name | The Asana milestone task name (tasks with resource_subtype = "milestone") |
Tasks
| What Syncs to Mosaic | Where It Comes From in Asana |
|---|---|
| Task Description | The task name |
| Task Note | The task notes/details |
| Assignee | The team member assigned to the task |
| Start Date | The task start date |
| End Date | The task due date |
| Completed Status | Whether the task is marked as completed |
Asana Documentation Links
A consolidated reference of all Asana documentation referenced in this guide:
| Topic | Link |
|---|---|
| API Reference | Asana REST API Reference |
| Users | Get User |
| Projects | Get Project |
| Sections | Get Section |
| Tasks | Get Task |
Related Documentation
Updated 7 minutes ago
