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 typeCloud (Asana REST API)
Setup complexityLow
PrerequisiteAsana 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 TypeDescription
1EmployeesAsana team members mapped to Mosaic employees
2ProjectsAsana projects with names, IDs, notes, and dates
3PhasesAsana sections mapped as project phases
4MilestonesAsana milestone tasks mapped as Mosaic milestones
5TasksAsana 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.

SymbolMeaningExample
.API object field referenceProject.name = the name field from the Project object

Detailed Field Mappings

Jump to a section: Employees | Projects | Phases | Milestones | Tasks


Employees

What Syncs to MosaicWhere It Comes From in Asana
Employee NameThe team member's name (from Teams → Team Settings → Members)
Employee EmailThe team member's email address

Projects

What Syncs to MosaicWhere It Comes From in Asana
Project TitleThe Asana project name
Project NumberThe Asana project ID
Project DescriptionThe Asana project notes
Start DateThe project start date
End DateThe project due date

Phases

What Syncs to MosaicWhere It Comes From in Asana
Phase NameThe Asana section name within a project

Milestones

What Syncs to MosaicWhere It Comes From in Asana
Milestone NameThe Asana milestone task name (tasks with resource_subtype = "milestone")

Tasks

What Syncs to MosaicWhere It Comes From in Asana
Task DescriptionThe task name
Task NoteThe task notes/details
AssigneeThe team member assigned to the task
Start DateThe task start date
End DateThe task due date
Completed StatusWhether the task is marked as completed

Asana Documentation Links

A consolidated reference of all Asana documentation referenced in this guide:

TopicLink
API ReferenceAsana REST API Reference
UsersGet User
ProjectsGet Project
SectionsGet Section
TasksGet Task

Related Documentation