Skip to main content

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:
CategoryAccess Level
metadataread
pull_requestswrite
secretswrite
workflowswrite
membersread
checkswrite
contentsread
eventsread
webhookswrite

Step 1: Make Your GitHub App Public

  1. Go to your GitHub App settings
    Navigate to your GitHub account → SettingsDeveloper settingsGitHub Apps.
  2. Select your GitHub App.
  3. Under the Advanced section, click Make Public.
  4. Confirm the action when prompted.
GitHub App Make Public Setting

Step 2: Configure OAuth Callback

While creating or editing your GitHub App:

  1. Navigate to the General tab under your app settings.
  2. In the Callback URL field, enter: