KnowledgeFix webhook issues

Webhooks are how Mesrai 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 SettingsWebhooks
  2. Find the Mesrai webhook
  3. Click on it and check Recent Deliveries
  4. Look for failed deliveries (non-2xx status codes)

GitLab

  1. Go to your project SettingsWebhooks
  2. Find the Mesrai webhook
  3. Check the delivery history for errors

Common fixes

Webhook URL is wrong or outdated

If you changed your Mesrai 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 Mesrai 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 Mesrai 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: