In this section
Errors your webhook URL can return
What 404, 410 and 429 mean when a service sends to your webhook URL, why each happens, and what to do. Plus the X-Request-ID header that ties a response to a captured request.
A live webhook URL answers every request with the response you've set, which is 200 by default. When something is wrong with the URL itself, it answers with one of these instead. The service sending to it will usually show the status in its delivery log.
The errors
| Status | Message | Means | What to do |
|---|---|---|---|
404 |
"This webhook URL does not exist." | The address isn't a webhook.stream URL. Usually it's mistyped or cut short | Copy the URL again with Copy and paste it in full |
410 |
"This webhook URL has expired." | Its time ran out, and everything it caught was erased | Create a new URL and update the service. A Pro pass prevents this for URLs you keep |
410 |
"This webhook URL has been deleted." | Someone deleted it from the inspector | Create a new URL |
429 |
"This webhook URL is receiving requests too quickly." | More than 600 requests in a minute. The response includes Retry-After: 10 |
Slow the sender down. Requests over the limit aren't recorded |
429 |
"This webhook URL has reached its lifetime request limit." | It has received 25,000 requests (1,000,000 with a Pro pass) | Create a new URL |
429 |
"Too many requests." | One network asked for many addresses that don't exist | Check the URL, and wait a minute |
Error responses are JSON, with an error code and a message, for example:
{ "error": "expired", "message": "This webhook URL has expired." }
Your own response
A status you set yourself under Response isn't an error from webhook.stream. If you set 500 to test failures, every request gets 500, but they're all recorded. Check the Response button: it shows the status when it isn't 200. See Set a custom response.
Match a response to a request
Every answer from a live URL carries an X-Request-ID header. Its value is the captured request's ID. Paste it into Filter requests to find that exact request in the inspector.
