Getting Started
Connect your first repository
Install the Zapat GitHub App and authorize your repositories in 3 steps.
Updated March 3, 2026
Connecting a repository takes about 2 minutes. You will install the Zapat GitHub App and grant it access to the repos you want Zapat to automate.
Step 1: Install the GitHub App
From the Zapat dashboard, go to the onboarding flow or the Repositories section. Click "Install Zapat on GitHub" — this opens the GitHub App installation page in a popup window. If popups are blocked, you will be redirected directly.
Step 2: Select repositories
On the GitHub installation page, choose "Only select repositories" and pick the specific repos you want Zapat to access. We recommend starting with a single, low-risk repo to test the pipeline. You can always add more repositories later from GitHub's Installed Apps settings.
Step 3: Return to the dashboard
After installing the App, Zapat automatically imports your selected repositories and creates a project for them. The dashboard then shows your connected repos and any open issues, so you can immediately pick one to trigger your first job.
Note
Zapat only accesses repositories you explicitly authorize. You can revoke access at any time from GitHub's "Installed GitHub Apps" settings under your account or organization.
What happens after connecting
- Zapat registers a webhook on your GitHub App installation — no manual webhook setup needed.
- Your repos appear in the Repositories section of the dashboard.
- Zapat is now listening for label events and @zapat mentions on those repos.
- Adding any "zapat:" label — or commenting @zapat — on an issue or PR will trigger the pipeline.
Was this article helpful?