Step 1: Check the Log Detail #
- Go to DDLS > Webhooks > Logs
- Find the failed delivery
- Click to open the log detail modal
- Review:
– Response Code: What did your endpoint return?
– Response Body: Any error message from your server?
– Error Message: Any WordPress-side error?
– Retry Count: How many attempts have been made?
Common Response Codes and What They Mean #
| Response Code | Cause | Action |
|---|---|---|
0 or blank | Network error, DNS failure, or timeout | Check endpoint URL and server availability |
401 / 403 | Authentication rejected by your server | Check Authorization custom header on the endpoint |
404 | Endpoint URL not found | Verify the URL is correct and the route is registered |
410 | Endpoint has been permanently removed | Endpoint is auto-disabled — see Endpoint Disabled |
422 | Your server rejected the payload structure | Check payload format; review dmsi_webhook_transform_payload filters |
429 | Your server is rate limiting DMSI Webhooks | Increase rate limits on your receiver or reduce delivery frequency |
500–599 | Your server threw an error | Check your server logs; retries will be attempted |
timeout | Request exceeded the endpoint timeout setting | Increase timeout in endpoint settings; optimize receiver response time |
My Endpoint Returns 200 But I See No Data #
If your endpoint returns 200 immediately without processing the payload body, it may be responding before reading the request. Ensure your receiver reads and parses the body before responding.
Deliveries Are Not Arriving at All #
- Verify the event is firing: check if a log entry with
pendingstatus was created - If no log entry exists, the event may not be firing in DDLS Core, or the endpoint is not subscribed to the event
- Check Action Scheduler queue: Tools > Scheduled Actions → search for
dmsi_webhooks_deliver - If the Action Scheduler job shows as
failed, check the PHP error log
SSL Certificate Errors #
If your endpoint uses a self-signed SSL certificate or has SSL issues, DMSI Webhooks will fail with a connection error. To temporarily bypass SSL verification for testing:
- Go to DDLS > Webhooks > Settings
- Enable Disable SSL Verification (for testing only — do not use in production)
Related Topics #
- Delivery Status Reference
- Endpoint Disabled (410 Gone)
- Queue Issues
