Diagnosis

How It Works

When a webhook delivery fails, HookSense automatically analyzes the error and provides an actionable diagnosis. This is integrated into the Retry History view.

Error Categories

Category	Examples	Suggestion
Auth	401 Unauthorized, 403 Forbidden	Check API keys and permissions
Not Found	404	Verify the endpoint URL exists
Method	405 Method Not Allowed	Check if the HTTP method is correct
Payload	413 Payload Too Large	Reduce request body size
Rate Limit	429 Too Many Requests	Reduce request frequency or increase limits
Server	500, 502, 503	Check the target server's health
Network	DNS failure, connection refused/reset	Check DNS settings and firewall rules
SSL	Certificate errors	Verify SSL certificate is valid
Timeout	Response exceeds 30s	Optimize handler performance
Signature	HMAC mismatch	Update signing secret

Diagnosis Output

Each diagnosis includes:

• Category — Classification of the error type
• Title — Human-readable error name
• Severity — Warning, error, or info
• Suggestion — Specific steps to resolve the issue

Requires Sense plan.