Documentation
Push Webhooks
PolyLever receives webhook events from GitHub when you install the app or push code. These events keep your dashboard in sync and trigger automatic reviews.
How it works
When you install the PolyLever GitHub App, GitHub sends events to PolyLever's webhook endpoint. No manual webhook setup is required — the app registration handles it automatically.
Events PolyLever handles
| Event | When it fires | What PolyLever does |
|---|---|---|
| installation | You install, update, or uninstall the GitHub App. | PolyLever registers or removes the installation and syncs repository access. |
| installation_repositories | You add or remove repositories from an existing installation. | PolyLever updates which projects are connected and active. |
| push | You push commits to a connected branch. | PolyLever creates a review for the commit range and queues the AI analysis. |
Push event details
- Every push to a tracked branch creates a new review record.
- Branch creation pushes (initial commit on a new branch) are skipped.
- The review captures the before and after commit SHAs for the diff window.
- If the repository is not connected, the push is logged but no review is created.