Skip to content
TeamLoop

Asana Integration

Connect Asana to search tasks, subtasks, and project activity across your workspaces.

What You Can Query

Section titled “What You Can Query”
Content TypeDescription
TasksWork items with assignees, due dates, custom fields
SubtasksChecklist items within parent tasks
ProjectsTask groupings and project membership
CommentsDiscussion threads on tasks
ActivityAssignment, status, and field change history

Connecting Asana

Section titled “Connecting Asana”
  1. Log into TeamLoop at app.teamloop.io
  2. Navigate to Settings > Integrations
  3. Click Connect next to Asana
  4. Enter your Asana Personal Access Token (PAT)
  5. TeamLoop validates the token and saves it encrypted

Creating an Asana PAT

Section titled “Creating an Asana PAT”
  1. Go to app.asana.com/0/my-apps
  2. Click Create new token
  3. Give it a name (e.g., “TeamLoop”)
  4. Copy the token and paste it into TeamLoop

Your PAT provides read access to all workspaces and projects your Asana account can access. We never write to your Asana workspace.

Example Queries

Section titled “Example Queries”

Search Tasks

Section titled “Search Tasks”
teamloop_query:
  query: "homepage redesign"
  sources: "asana"

Find Overdue Work

Section titled “Find Overdue Work”
teamloop_query:
  query: "overdue backend tasks"
  sources: "asana"

Track a Project

Section titled “Track a Project”
teamloop_query:
  query: "Q1 launch project"
  sources: "asana"

Automatic Change Tracking

Section titled “Automatic Change Tracking”

TeamLoop automatically tracks changes from Asana via the Stories API.

Task Timeline

Section titled “Task Timeline”

When you query a task, TeamLoop fetches its activity history:

  • Status changes (open, completed)
  • Assignee changes
  • Section/column changes
  • Due date changes
  • Title and description edits
  • Tag additions and removals
  • Comments

Entity Extraction

Section titled “Entity Extraction”

Asana content maps to TeamLoop entity types:

Asana ContentTeamLoop Entity
TaskDOCUMENT
ProjectPROJECT
CommentDOCUMENT
AssigneePERSON
Status changeCHANGE
Section changeCHANGE

Temporal Queries with Asana

Section titled “Temporal Queries with Asana”

Point-in-Time

Section titled “Point-in-Time”

See the state of Asana tasks on a specific date:

teamloop_query:
  query: "product launch tasks"
  sources: "asana"
  mode: "as_of"
  as_of: "2024-06-01"

Evolution

Section titled “Evolution”

Track how a project progressed over a quarter:

teamloop_evolution:
  query: "homepage redesign"
  from_date: "2024-01-01"
  to_date: "2024-03-31"

Troubleshooting

Section titled “Troubleshooting”

No Results

Section titled “No Results”
  • Verify the Asana integration is connected
  • Check that your Asana account has access to the workspace
  • Try broader search terms
  • Asana search is workspace-scoped; ensure the target workspace is your default

Missing Tasks

Section titled “Missing Tasks”
  • Check project permissions in Asana
  • Private projects require your account to be a member
  • If workspace access changed recently, your existing PAT reflects new permissions automatically

Security

Section titled “Security”
  • API tokens are encrypted at rest using pgcrypto
  • Tokens can be revoked from Asana developer console
  • TeamLoop only reads, never writes
  • You can disconnect at any time from TeamLoop settings
  • Connected tokens show a hint so you can identify which token is in use

Next Steps

Section titled “Next Steps”