# Webhooks diagnostics

<!-- Generated by docs/modules/diagnostics from the package catalogs. Write a guide in docs/diagnostics/<CODE>.md instead of editing this file. -->

Each Webhooks error has a stable `code`. Its `docs` link opens the page of that code. This page lists all 18 codes, and [All diagnostics](https://vitehub.dev/docs/reference/diagnostics) lists every primitive.

## Runtime errors

| Code | What happened |
| --- | --- |
| [`WEBHOOKS_BODY_INVALID`](https://vitehub.dev/docs/webhooks/diagnostics/webhooks_body_invalid) | The body for the webhook \<webhook\> is not JSON data. |
| [`WEBHOOKS_DATABASE_MISSING`](https://vitehub.dev/docs/webhooks/diagnostics/webhooks_database_missing) | Webhooks has no Database in this server. |
| [`WEBHOOKS_DELIVERY_ACTIVE`](https://vitehub.dev/docs/webhooks/diagnostics/webhooks_delivery_active) | The delivery \<id\> is \<state\>, so it cannot be delivered again yet. |
| [`WEBHOOKS_DELIVERY_FAILED`](https://vitehub.dev/docs/webhooks/diagnostics/webhooks_delivery_failed) | The webhook \<webhook\> was not delivered: \<reason\>. |
| [`WEBHOOKS_DELIVERY_NOT_FOUND`](https://vitehub.dev/docs/webhooks/diagnostics/webhooks_delivery_not_found) | No webhook delivery has the id \<id\>. |
| [`WEBHOOKS_DELIVERY_NOT_PENDING`](https://vitehub.dev/docs/webhooks/diagnostics/webhooks_delivery_not_pending) | The delivery \<id\> is \<state\>, not pending. |
| [`WEBHOOKS_SECRET_UNSET`](https://vitehub.dev/docs/webhooks/diagnostics/webhooks_secret_unset) | The webhook \<webhook\> signs each delivery with the secret in `<name>`, but this server has no value for it. |
| [`WEBHOOKS_STORE_FAILED`](https://vitehub.dev/docs/webhooks/diagnostics/webhooks_store_failed) | Webhooks could not \<action\> in the Database. |
| [`WEBHOOKS_URL_INVALID`](https://vitehub.dev/docs/webhooks/diagnostics/webhooks_url_invalid) | The webhook \<webhook\> reads its URL from `<name>`, but the value is not an http or https URL. |
| [`WEBHOOKS_URL_UNSET`](https://vitehub.dev/docs/webhooks/diagnostics/webhooks_url_unset) | The webhook \<webhook\> reads its URL from `<name>`, but this server has no value for it. |
| [`WEBHOOKS_WAKE_FAILED`](https://vitehub.dev/docs/webhooks/diagnostics/webhooks_wake_failed) | The delivery of the webhook \<webhook\> is stored, but the Queue did not accept its job. |

## Definition and build errors

| Code | What happened |
| --- | --- |
| [`WEBHOOKS_DATABASE_OFF`](https://vitehub.dev/docs/webhooks/diagnostics/webhooks_database_off) | Webhooks keeps each delivery in the Database, but the app has no Database. These files define webhooks: \<files\>. |
| [`WEBHOOKS_DEBOUNCE_TOO_LONG`](https://vitehub.dev/docs/webhooks/diagnostics/webhooks_debounce_too_long) | The debounce \<debounce\> is longer than 24 hours. Cloudflare Queues delays a message at most 24 hours, and a webhook must work on every host. |
| [`WEBHOOKS_DEFINITION_INVALID`](https://vitehub.dev/docs/webhooks/diagnostics/webhooks_definition_invalid) | \<message\> |
| [`WEBHOOKS_FILE_INVALID`](https://vitehub.dev/docs/webhooks/diagnostics/webhooks_file_invalid) | The webhook \<value\> needs a name of lowercase letters, digits, and dashes, such as t3 or slack-alerts. |
| [`WEBHOOKS_NOT_FOUND`](https://vitehub.dev/docs/webhooks/diagnostics/webhooks_not_found) | No webhook is named \<name\>. |
| [`WEBHOOKS_NOT_INSTALLED`](https://vitehub.dev/docs/webhooks/diagnostics/webhooks_not_installed) | Webhooks is not running in this server. The app has no `server/webhooks/` files, or the code runs outside the ViteHub server. |
| [`WEBHOOKS_QUEUE_OFF`](https://vitehub.dev/docs/webhooks/diagnostics/webhooks_queue_off) | Webhooks sends each delivery through the Queue, but the app has no Queue. These files define webhooks: \<files\>. |

<!-- vitehub-docs:section-links -->
## In this section

- [Overview](https://vitehub.dev/raw/docs/webhooks.md)
- [Get started](https://vitehub.dev/raw/docs/webhooks/get-started.md)
- [Configure](https://vitehub.dev/raw/docs/webhooks/configure.md)
- [Server API](https://vitehub.dev/raw/docs/webhooks/server-api.md)
- [Hosts](https://vitehub.dev/raw/docs/webhooks/hosts.md)
- [Limits and errors](https://vitehub.dev/raw/docs/webhooks/limits-and-errors.md)
- [Comments to T3 Code](https://vitehub.dev/raw/docs/webhooks/t3-code-thread.md)
- [Send events](https://vitehub.dev/raw/docs/webhooks/send-events.md)

All pages: [llms.txt](https://vitehub.dev/llms.txt)
