Skip to content

Pre-commit Webhooks v1 #3351

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
wants to merge 6 commits into
base: main
Choose a base branch
from
Draft

Pre-commit Webhooks v1 #3351

Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
c89cd32
Pre-commit Webhooks v1
mseger-statsig Aug 12, 2025
b607668
Merge branch 'main' into mseger-statsig-precommit-webhooks
mseger-statsig Aug 25, 2025
4877ae0
Precommit Webhooks v2
mseger-statsig Aug 25, 2025
089e3a3
Merge branch 'main' into mseger-statsig-precommit-webhooks
mseger-statsig Sep 2, 2025
f135970
Merge branch 'main' into mseger-statsig-precommit-webhooks
mseger-statsig Sep 4, 2025
c96a47d
Merge branch 'main' into mseger-statsig-precommit-webhooks
mseger-statsig Sep 4, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 15 additions & 0 deletions docs/guides/setting-up-reviews.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -57,3 +57,18 @@ By default if you have turned on "Reviews Required" for your Project, reviews wi
![Screen Shot 2023-04-11 at 9 47 12 AM](https://user-images.githubusercontent.com/101903926/231233087-5b87310d-b33b-456e-b1a7-7a73555c8100.png)

![Screen Shot 2023-04-11 at 9 48 02 AM](https://user-images.githubusercontent.com/101903926/231233356-967c9785-5a89-4cac-a04a-e3f11cb7bb12.png)

### Configuring Custom Approval Workflows (Pre-commit Webhooks)
If you prefer to leverage an internal approvals workflow or, for example, want to run proposed config changes through a suite of automated tests before they go live, you can leverage **Pre-commit Webhooks**. Pre-commit Webhooks enable you to listen for config changes on the Statsig side, route those changes through internal approval processes, test suites, etc. and then leverage Console API to send back either a review approval or rejection before final changes can be committed.

To set up the webhook itself, navigate to **Settings** -> **Integrations** -> **Webhook**.
<img width="1590" height="1179" alt="Screen Shot 2025-08-12 at 4 28 12 PM" src="https://github.com/user-attachments/assets/fe50bc53-9a91-44f8-94c6-adca738ee88d" />

To enable the Pre-commit Webhook experience:
1. Configure change validations via Console API, see documentation [here](https://docs.statsig.com/console-api/change-validation/).
2. Configure the experience for Statsig Console users via **Settings** -> **General**, where you will be able to configure the "Pending State" banner text, URL, and a Pre-commit Webhook key for verification purposes.

Now, when a change is made in the Statsig Console, Statsig hits the customer’s configured webhook with the proposed changes. The change in Statsig will be pending until the customer approves the review via Console API (after their internal checks are complete). Statsig exposes an option for Project Admins (only) to bypass this process and commit the changes directly.