WarpBuild LogoWarpBuild Docs
Apps

GitHub

The GitHub integration lets you programmatically manage repositories, automate pull request workflows, handle issues, manage CI/CD pipelines, and integrate with GitHub's development platform directly from Helios.

Authentication

MethodTypeDescription
Helios GitHub App (Recommended)GitHub AppSeamless integration with automatic permissions
Personal Access TokenToken-basedSimple token authentication with custom scopes
BYO GitHub AppGitHub AppCustom GitHub App for enterprise requirements

The Helios GitHub App provides seamless integration with automatic permission management and webhook configuration.

Personal Access Token

Another simple way to connect GitHub is using a Personal Access Token (PAT) with the required scopes for your use case.

Setup Steps

  1. Go to GitHub Settings → Developer settings → Personal access tokens
  2. Click Generate new token → Generate new token (classic)
  3. Select the required scopes for your workflows
  4. Copy the generated token and paste it into Helios
  5. Save your integration

Common Scopes

  • repo - Full access to repositories
  • public_repo - Access to public repositories only
  • workflow - Update GitHub Actions workflows
  • read:org - Read organization membership
  • user:email - Access user email addresses

BYO GitHub App

Create your own GitHub App for enterprise requirements or custom permission management.

Setup Steps

  1. Go to GitHub Settings → Developer settings → GitHub Apps
  2. Click New GitHub App
  3. Configure app permissions, webhook URL, and events
  4. Generate and download a private key
  5. Install the app on your repositories
  6. Configure the app in Helios with app ID, installation ID, and private key

Learn more about creating GitHub Apps in the GitHub documentation.

Functionality

The GitHub integration lets your workflows manage repositories, automate development workflows, handle CI/CD processes, and integrate with GitHub's ecosystem without writing custom code.

CategoryFeatures
Repository ManagementCode Operations, Branch Management, Tag and Release Management, Repository Settings, Collaborator Management
Issue and Project ManagementIssues, Labels, Milestones, Projects, Discussions
Pull Request AutomationPR Management, Code Reviews, Status Checks, Comments, Draft PRs
CI/CD IntegrationGitHub Actions, Deployment Status, Check Runs, Artifacts

Webhook Events

Event CategoryEvent Types
Repository EventsPush, Branch, Tag, Repository
Issue EventsIssues, Issue Comments, Milestones
Pull Request EventsPull Requests, Pull Request Reviews, Pull Request Review Comments
Workflow EventsWorkflow Run, Workflow Job, Check Run
Security EventsSecurity Advisory, Vulnerability Alert, Code Scanning

API Versions

The integration supports multiple GitHub API versions:

GitHub.com (2022-11-28)

Latest API version for GitHub.com with all current features.

GitHub Enterprise Cloud (GHEC)

API version for GitHub Enterprise Cloud with enterprise-specific features.

GitHub Enterprise Server (GHES 3.17)

API version for self-hosted GitHub Enterprise Server instances.

Rate Limits

// TODO: Add the link to GitHub rate limits

Last updated on