---
title: "Test Webhook"
method: POST
path: "/api/reddit/monitor/webhook/test"
tags: ["Monitoring"]
---

# Test Webhook

`POST /api/reddit/monitor/webhook/test`

## Request

- Base URL: `https://api.redditapis.com`
- URL: `https://api.redditapis.com/api/reddit/monitor/webhook/test`
- Auth: HTTP bearer

Send a one-off test delivery to a registered webhook (rate-limited to 10/min) to confirm it's wired up correctly. On failure the response carries reason and status plus hint (our sentence naming the fix, most often that the target's kind does not match its host) and detail (a bounded, sanitised copy of what the destination itself replied). Returns 404 webhook_not_found, or webhook_url_rejected if the URL fails re-validation (e.g. now resolves to a private address). Cost: Free per call.

## Request body

- object
  - `id` string, required: The webhook's id.

## Response `200`

Successful response.

- object

## Other responses

- `400`: Bad request — missing or invalid parameters.
- `401`: Missing Bearer token.
- `403`: Invalid Bearer token.
- `429`: Rate limit exceeded.
- `500`: Unexpected server error.
- `502`: Upstream (Reddit) rejected the request — cookies expired or account flagged.

---

[API](https://skmtc.dev/redditapis/apis/redditapis-api.md) · [All operations](https://skmtc.dev/redditapis/apis/redditapis-api/llms.txt) · [OpenAPI document](https://skmtc.dev/redditapis/apis/redditapis-api/revisions/9696482dfe9b?raw)