Authorization
Connect the GitHub account with access to the repositories your workflow needs.
Read GitHub OAuth guidance →CONNECT CODE REVIEW TO PROJECT WORK
Connect GitHub repositories to Aqtos projects.
The GitHub integration authorizes repository access and maps repositories to Aqtos projects for review tasks. People mappings connect GitHub users to the colleagues who should receive those tasks.
Three pieces to configure.
Repositories
Pair a GitHub repository with the Aqtos project where review work belongs.
See the mapping steps →People
Map GitHub identities to Aqtos users for review task assignment.
Configure people mappings →Set up the GitHub connection.
- Open the GitHub panel.
In Aqtos, go to Tech → Integrations → GitHub → Configure. Use OAuth Integration to authorize repository access with the appropriate GitHub account.
- Review the authorization.
Check the requested access and any organization approval requirements in GitHub. Continue with the repositories needed for your team’s work.
- Map a repository to a project.
Under Repositories & projects, select a GitHub repository and an Aqtos project. Choose Save mapping and confirm the pairing appears in the mappings list.
- Map the people.
Under People, match the relevant GitHub users to their Aqtos accounts. This tells the review workflow who the corresponding colleague is.
- Verify the workflow.
Use a small review example in a mapped repository. Check that the resulting work reaches the right Aqtos project and person before expanding to more repositories.
GitHub setup questions
Why can’t I see the repository?
Check the connected GitHub account’s repository access and whether the organization requires OAuth app approval. Revisit authorization with your GitHub administrator if necessary.
Why is a review task assigned incorrectly?
Check both mappings: the repository should point to the intended project, and the GitHub user should match the right Aqtos colleague.
Does this migrate every GitHub issue?
Do not treat repository authorization as a full historical issue import. Confirm the events and records needed for your workflow with Aqtos before planning a migration.
Does Aqtos replace GitHub?
GitHub remains the place for your repositories and development workflow. The connection brings the relevant project work into Aqtos.
Put it to work with your team.
Use a real project to see how Aqtos connects work, people and money. Need help with a particular workflow? Bring it to a demo.
14-day trial. Card required. Monthly Pro plan: $199 after the trial. Pricing details.
Sources and useful links
Reviewed September 6, 2026.