Skip to main content
Webhooks are how Fossa knows when a PR is opened or updated. If they’re not working, reviews won’t trigger.

​
Diagnosing the issue

​
GitHub

  1. Go to your repository Settings → Webhooks
  2. Find the Fossa webhook
  3. Click on it and check Recent Deliveries
  4. Look for failed deliveries (non-2xx status codes)

​
GitLab

  1. Go to your project Settings → Webhooks
  2. Find the Fossa webhook
  3. Check the delivery history for errors

​
Common fixes

​
Webhook URL is wrong or outdated

If you changed your Fossa deployment URL, update the webhook URL in your Git provider settings.

​
SSL certificate issues

If you’re self-hosting, ensure your SSL certificate is valid. GitHub and GitLab reject webhooks with invalid certificates.

​
Firewall blocking

If Fossa is behind a firewall, ensure your Git provider’s IP ranges can reach the webhook endpoint.

​
Webhook was deleted

Re-register the webhook by going through the Fossa setup flow again, or manually add the webhook URL.

​
Testing

Most Git providers let you redeliver a recent webhook payload. Use this to test without creating a new PR. For platform-specific guides, see: