Skip to main content

​
Connecting GitHub to Prizm

Setting up the GitHub App integration takes four steps: installing Prizm Pulse from the GitHub Marketplace, configuring the webhook so GitHub notifies Prizm of PR events, obtaining the Installation ID, and entering the repository and branch details in Prizm.

​
Prerequisites

  • GitHub Organization administrator access
  • Repository administrator permissions for repositories to be monitored
  • Admin or privileged user access in Prizm to configure integrations

​
Step 1: Install Prizm Pulse from the GitHub Marketplace

  1. Navigate to Prizm Pulse in the GitHub Marketplace.
  2. Click Install and select the GitHub Organization to install the app on.
  3. Choose repository access:
    • All repositories — recommended for organization-wide monitoring
    • Selected repositories — grant access only to the dbt repositories Prizm should monitor
  4. Review the requested permissions and approve the installation.

​
Permissions required (read-only)

  • Pull Requests
  • Repository Metadata
  • Branch Information
  • Commit Metadata

​
Step 2: Configure the webhook URL

1

Open GitHub App settings

In GitHub, navigate to Organization Settings → Developer Settings → GitHub Apps → Prizm Pulse.
2

Set the webhook URL

Open the Webhook section and enter:
Replace <your-prizm-domain> with your Prizm instance hostname (e.g., <your-workspace>.prizmdata.ai).
3

Enable the webhook and save

Toggle the webhook on and save. GitHub will now deliver PR open, merge, and close events to Prizm in real time.

​
Step 3: Obtain the Installation ID

After installation, GitHub redirects to a URL in this format:
The number at the end is your Installation ID. Copy and save it.

​
Step 4: Configure the GitHub App in Prizm

1

Open Integration settings

Navigate to Organization → Integration, click the + icon and select the GitHub App tile. To change an existing integration, click the pencil icon on the GitHub App row instead.
2

Enter the Installation ID

Paste the numeric Installation ID obtained in Step 3.
3

Add repositories and branches

In the GitHub details section, enter the repository identifier in Repo Name (e.g., my-org/dbt-project). In Branch Names, type each target branch and press Enter to add it as a tag (e.g., main, develop, prod). Click the + icon next to GitHub details to add a row for each additional repository.
4

Save

Click Create Integration (the button reads Update Integration when you edit an existing integration). Prizm validates the Installation ID and begins monitoring the configured repositories.
GitHub App form with the Installation ID field and the GitHub details row with Repo Name and Branch Names

GitHub App form: Installation ID and GitHub details

​
Configuration reference

​
Updating repository access

To add a new repository after the initial setup:
  1. In GitHub, go to Organization Settings → Installed GitHub Apps → Prizm Pulse and add the new repository to the app’s access list.
  2. In Prizm, navigate to Organization → Integration → GitHub App and add a new row with the repository name and target branches.
Both steps are required. If the app does not have access to a repository listed in Prizm, monitoring for that repository will fail silently.