Troubleshooting Webhooks
If your webhooks aren't arriving or are failing verification, here's how to debug.
Viewing Delivery Logs
WaitlistPilot logs every webhook attempt.
- Go to Settings → Webhooks.
- Scroll down to the Webhooks section.
- Click on an endpoint to expand it.
- You will see a list of Recent Deliveries with status codes (200, 400, 500, etc.) and timestamps.
Common Errors
HTTP 401 / Invalid Signature
This usually means the secret you are using to verify the signature doesn't match the one in the dashboard. Check that your environment variable is correct. Also ensure you are hashing the raw body, not the parsed object.
Timeouts
Your server must respond within 10 seconds. If you have long-running logic (like sending an email or sync to a slow CRM), acknowledge the webhook immediately with a 200 OK and process the work in the background.
Localhost URLs
We cannot send webhooks to localhost. Use a tunneling service like ngrok or Cloudflare Tunnel to expose your local server.
Retries
Failed deliveries are retried with exponential backoff. If your endpoint continues to fail or time out, deliveries may be paused. Keep an eye on the delivery log and fix issues on your side to restore healthy 2xx responses.