---
title: "Test Webhook"
method: POST
path: "/monitoring/webhooks/{webhook_id}/test"
tags: ["monitoring"]
---

# Test Webhook

`POST /monitoring/webhooks/{webhook_id}/test`

## Request

- Base URL: `https://api.licenscheck.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.licenscheck.com/monitoring/webhooks/{webhook_id}/test`
- Auth: none declared

Send a signed `webhook.test` delivery to a webhook now, and say how it went.

For checking a receiver and its signature verification; it isn't an
event, isn't in the feed and isn't retried. `Licenscheck-Event-Id` is
"test".

Args:
    webhook_id: The webhook's ID.
    api_key_id: Injected: the caller's key.
    monitoring: Injected `MonitoringRepository`.
    client: Injected HTTP client.
    resolve: Injected DNS lookup, for the address check.

Returns:
    Whether it was answered with a 2xx, the status, and the error if any.

Raises:
    HTTPException: 404 if this key has no active webhook with that ID; 503 when webhooks are off.

## Path parameters

- `webhook_id` string, uuid, required

## Response `200`

Successful Response

- WebhookTestOut: Response for POST /monitoring/webhooks/{id}/test: how a signed test delivery went.
  - `delivered` boolean, required: Whether the endpoint answered with a 2xx.
  - `status` integer, nullable, required: The HTTP status it answered with, if any.
  - `error` string, nullable, required: Why it failed, if it did.

## Other responses

- `401`: No API key, or one that's wrong or revoked.
- `403`: A free key: monitoring needs a paid plan.
- `404`: This key has no active webhook with that ID.
- `422`: Validation Error
- `503`: Webhooks aren't available yet.

---

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