Troubleshooting
    4 min read

    Webhook Delivery Failures

    Debug and fix webhook issues

    Webhook Delivery Failures

    Diagnose and fix webhook delivery problems.

    Check Webhook Logs

  1. Go to Settings → Webhooks
  2. Click on the webhook
  3. View Delivery Logs
  4. Check status codes and responses

    5. Common Failure Reasons

    HTTP 400 Bad Request

    Cause: Your endpoint rejected the payload

    Fix:

  5. Verify your endpoint accepts POST requests
  6. Check Content-Type is application/json
  7. Validate your payload parsing

    8. HTTP 401/403 Unauthorized

    Cause: Authentication failed

    Fix:

  8. Check your endpoint auth configuration
  9. Verify webhook signature validation
  10. Ensure secrets match

    11. HTTP 500 Server Error

    Cause: Your server had an error

    Fix:

  11. Check your server logs
  12. Ensure endpoint handles the payload
  13. Add error handling

    14. Timeout (no response)

    Cause: Endpoint didn't respond in 30 seconds

    Fix:

  14. Optimize endpoint performance
  15. Return 200 immediately, process async
  16. Check server availability

    17. Retry Policy

    Failed webhooks are retried:

  17. 1st retry: 1 minute
  18. 2nd retry: 10 minutes
  19. 3rd retry: 1 hour
  20. 4th retry: 24 hours

    21. Manual Replay

  21. Go to webhook delivery logs
  22. Find the failed delivery
  23. Click "Replay"
  24. Monitor the result

    25. Testing Webhooks

    Use the "Test Webhook" button to send a sample payload without affecting real data.

    Was this article helpful?

    Related Articles

    Webhook Signature Verification

    Secure your webhook endpoints

    API Authentication Issues

    Resolve API key and authentication errors

    webhooks
    errors
    debugging