GitHub Integration

Connect Zenflow Work to GitHub for repository management and pull requests.

Integration requires Zencoder account

Overview

Zenflow integrates with GitHub to streamline your development workflow. Connect your repositories, create pull requests directly from tasks, and sync status across platforms.

Connecting to GitHub

There are two ways to connect to Github - OAuth flow and Personal Access Token flow

OAuth

1. Open Zenflow Settings

   Navigate to Settings in the Zenflow sidebar.

2. Find Github under Development

   Scroll to the Development section and locate Github.

3. Click Connect

   Click Connect, select Connect with OAuth

   

   Click the link shown in the modal or click here Select the account you want to connect if you have multiple

   

   Enter code shown in Zenflow and click Continue

   

   Click Authorize zencoderai

   

   You should see confirmation page

   
4. Integration enabled

   It can take a few seconds for the connection to get updated in Zenflow

   

Personal Access Token

1. Open Zenflow Settings

   Navigate to Settings in the Zenflow sidebar.

2. Find Github under Development

   Scroll to the Development section and locate Github.

3. Click Connect

   Click Connect, select Use Personal Access Token

   

   Click the link shown in the modal or click here After confirming your identity, you should land on New Personal Access Token (Classic) page

   

   Set token expiration date to your desired expiration date

   

   Make sure the scopes selected as shown on the screenshot - whole repo section and user:email in user section

   

   Click Generate token at the bottom of the page. You’ll be redirected to the page with all your token and shown the newly generated token

   The token is only shown once. Store it securely before leaving the page.

   

   Paste token in Zenflow and click Done

   
4. Integration enabled

   

Features

Clone from GitHub

When creating a new project, you can clone directly from GitHub:

1. Click New Project → Clone from GitHub
2. Select the repository
3. Choose the local directory
4. Zenflow clones and sets up the project

Create Pull Requests

When a task is complete:

1. Open the task’s context menu (⋯)
2. Click Create PR
3. Review the PR title and description (pre-filled from task)
4. Select target branch
5. Create the pull request

Zenflow pushes the task branch and opens the PR on GitHub.

PR Status Sync

Zenflow syncs PR status back to tasks:

GitHub Status	Task Status
PR Open	Review
PR Merged	Completed
PR Closed	Archived (optional)

Automated Workflows

Trigger Zenflow tasks from GitHub events:

• Issue created: Auto-create a Fix Bug task
• PR comment: Re-run agents with new instructions
• Review requested: Notify in Zenflow inbox

Authentication Options

OAuth (Recommended)

Standard GitHub OAuth flow—sign in with your GitHub account and authorize Zenflow.

Personal Access Token

For fine-grained control or organizations with OAuth restrictions:

1. Generate a token at GitHub → Settings → Developer settings → Personal access tokens
2. Required scopes: repo, workflow
3. Enter the token in Project → Settings → GitHub

GitHub App (Enterprise)

Organizations can install the Zenflow GitHub App for centralized access control:

• Admin manages permissions
• No individual tokens needed
• Audit logging for compliance

Repository Settings

Configure per-repository behavior:

Setting	Description
Default branch	Base for new tasks (usually main)
Branch prefix	Naming pattern for task branches
Auto-push	Push branches automatically
PR template	Default description template

Troubleshooting

Can't see my repository

Verify that your GitHub connection has access to the repository. For organization repos, an admin may need to grant access.

PR creation fails

Check that:

• The task branch has commits
• You have write access to the repository
• The target branch exists
• There are no GitHub branch protection conflicts

Webhook not triggering

Zenflow webhooks may be blocked by:

• Firewall rules
• GitHub organization settings
• Network connectivity issues

Check Project → Settings → Integrations for webhook status.

Next Steps

MCPs

Connect additional tools via MCP

Repository Configuration

Configure automation settings