Skip to content
ProjectBrain Docs
Work in progress: these docs are being written and change often.

Asana

Sync Asana projects, tasks and milestones into ProjectBrain timelines on a schedule. Asana stays the source of truth.

GAOwnerExecutiveLast updated 5 October 2026
WhoAdmins connect Asana and match people. Everyone sees the synced timelines on projects they can see.Roles

The Asana integration keeps project timelines in ProjectBrain up to date with Asana. Asana is the master: changes flow from Asana into ProjectBrain, never the other way.

Go to Settings > Integrations > Asana. There are two ways to connect:

  • Connect with OAuth signs in with your own Asana account.
  • Use Personal Access Token connects with a token from Asana, for example one belonging to a service account. Choose Test Connection, then Connect.

Once connected, the page shows the Asana Workspace, when it Last synced, and whether syncing is running, paused or has an error.

You link an Asana project to a ProjectBrain project in that project’s settings. Each ProjectBrain project links to one Asana project.

  • Projects and their details
  • Tasks and subtasks, with due dates
  • Sections and milestones
  • Task assignments and completion status
  • Dependencies between tasks

Asana tasks become entries on the project’s timeline, with subtasks nested under them. Comments and attachments are not synced. Edits made in ProjectBrain are not sent to Asana.

ProjectBrain checks every hour and syncs each linked project when its sync interval has passed.

Go to Settings > Integrations > Asana, then open the people page (Asana User Mappings). People appear after the first sync.

  • Auto-Match by Email matches everyone whose email is the same in both tools.
  • For the rest, pick a person from – Select Team Member –, or choose Create user.

Each person shows as Mapped or Unmapped, and whether the match was automatic or manual.

Choose Disconnect and confirm. All synced projects, tasks and milestones stay in ProjectBrain. Automatic sync stops, and you can reconnect at any time.