In this section · Requests and links

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.