How to integrate GitHub App account?
Overview
To integrate your GitHub App with Unizo, ensure the following pre-requisites and permissions are correctly configured:
- You must have the OrgAdmin role in the Unizo portal to configure app-based GitHub services.
Please contact your organization’s administrator if you don’t have the required permissions. - Your GitHub App must be publicly available.
- While creating your app, check the option “Request user authorization (OAuth) during installation”.
- Your app must be configured with the Callback URL:
https://api.unizo.io/cb/v1/github_app/callback - Choose Any account to allow your GitHub App to be installed by any user or organization.
- Ensure the following permissions are set:
| Category | Access Level |
|---|---|
| metadata | read |
| pull_requests | write |
| secrets | write |
| workflows | write |
| members | read |
| checks | write |
| contents | read |
| events | read |
| webhooks | write |
Step 1: Make Your GitHub App Public
- Go to your GitHub App settings
Navigate to your GitHub account → Settings → Developer settings → GitHub Apps. - Select your GitHub App.
- Under the Advanced section, click Make Public.
- Confirm the action when prompted.

Step 2: Configure OAuth Callback
While creating or editing your GitHub App:
- Navigate to the General tab under your app settings.
- In the Callback URL field, enter: