Troubleshooting
Request not showing up
| Check | What to do |
|---|---|
| Wrong URL | Copy the full webhook URL from the dashboard (/h/<endpoint-id>). Typos or wrong environment (staging vs prod API) are common. |
| Provider not sending | Use the provider’s “send test” or delivery logs to confirm they actually fired. |
| Endpoint expired | Free or time-limited endpoints may expire. Create a new endpoint or upgrade for longer TTL. |
| HTTP errors upstream | HookNexus records what arrived; if the provider retried, you may see multiple entries. |
WebSocket disconnects
- Network: Unstable Wi‑Fi or VPNs can drop long-lived connections—try a wired connection or disable flaky VPN split tunnels.
- Auth expiry: Refresh the page or sign in again if your session expired.
- Idle timeouts: Some corporate proxies kill idle sockets; refresh the dashboard or wait for the client to reconnect.
Signature verification fails
| Issue | Fix |
|---|---|
| Body altered | Verify HMAC over the raw body. Parsing JSON and re-stringifying breaks many schemes. |
| Wrong secret | Confirm live vs test keys and that the secret wasn’t rotated. |
| Wrong algorithm or header | Match provider docs (e.g. sha256=, prefix, timestamp inclusion). |
| Clock skew | If verification includes time windows, sync server time with NTP. |
See Signature verification for HookNexus-specific testing.
Quota exceeded
- You’ll see 429 or in-app notices when daily requests, endpoint count, or similar caps are hit.
- Upgrade your plan, delete unused endpoints, or reduce traffic from noisy integrations.
Login issues
- Cookies blocked: Allow cookies for HookNexus and auth domains; try an incognito window with extensions disabled to isolate blockers.
- OAuth popup blocked: Allow popups for the auth domain when using browser login.
- Different browser: Try another browser or device to rule out extensions or strict privacy settings.