Skip to main content

​
What gets indexed

  • Tasks - Most task fields including custom fields
  • Task comments - All comments on each task
  • Subtasks - Same as Tasks

​
Setup

You must be a Super Admin in Asana to properly authorize the Grapevine app. The preferred way to authorize is via Service Account. If you do not have access to a service account an administrator can OAuth.
1

Connect to Grapevine

In Grapevine, go to the Asana Integration
2

Create a Service Account

In Asana create a full permission service account. And record the generated token. Learn more about service accounts.
3

Authenticate Grapevine

Paste the service account token into the Grapevine Asana Integration and click connect.

​
Permissions

Grapevine requests full access because some APIs (specifically the memberships API) are not resource scoped. Grapevine only reads data via workspace, project, task, subtask, story, membership and team endpoints.
The Asana connector makes all synced tasks visible to people who can see them in Asana.

​
Sync behavior

  • Initial full sync - Begins automatically after authorization, progresses backwards in time so latest data should be available quickly.
  • Ongoing syncs - Runs every hour to capture incremental task updates

​
Limitations

  • A service account is highly recommended to connect and sync data.
  • Public projects are widely available in Grapevine but tasks that have been made “public” will not be widely available in Grapevine due to Asana API limitations.
  • Task updates follow the sync schedule, so changes in Asana may not appear in Grapevine immediately.