Asana GitHub SyncRule-based PR automation

Automatically sync GitHub pull requests to Asana tasks using flexible, declarative rules

⚡️

Rule-Based Automation

Define custom rules for different PR events. Create tasks, update fields, post comments - all triggered by PR lifecycle events.

🎯

Flexible Conditions

Match on event types, PR state, labels, authors, and more. Combine multiple conditions to create precise automation rules.

🔧

Task Management

Automatically create Asana tasks from PRs, update custom fields based on PR state, and mark tasks complete when PRs merge.

📝

Template System

Use Handlebars templates with custom helpers to generate dynamic content. Extract data from PR descriptions, comments, and more.

🔍

Type-Safe Configuration

YAML-based configuration with comprehensive validation. Catch errors before deployment with clear, actionable error messages.

🚀

Zero Dependencies

Pure GitHub Action with no external services required. Works with any Asana workspace using only your Personal Access Token.

Quick Example

yaml

name: Sync PR to Asana
on:
  pull_request:
    types: [opened, closed]

jobs:
  sync:
    runs-on: ubuntu-latest
    steps:
      - uses: planningcenter/asana-github-sync@main
        with:
          asana_token: ${{ secrets.ASANA_TOKEN }}
          github_token: ${{ github.token }}
          rules: |
            rules:
              # Update status when PR opens
              - when:
                  event: pull_request
                  action: opened
                then:
                  update_fields:
                    '1234567890': 'In Review'

              # Mark complete when PR merges
              - when:
                  event: pull_request
                  action: closed
                  merged: true
                then:
                  update_fields:
                    '1234567890': 'Shipped'
                  mark_complete: true

What makes this different?

Declarative rules instead of imperative scripts
Built-in validation to catch configuration errors early
Comprehensive templating for dynamic content generation
Real-world tested - used in production at Planning Center
Replaces multiple tools - consolidates various Asana/GitHub automation approaches

Get Started →