---
title: "Send a test event to a webhook endpoint"
method: POST
path: "/webhooks/configs/test"
tags: ["Webhooks"]
---

# Send a test event to a webhook endpoint

`POST /webhooks/configs/test`

Relays the customer endpoint's response: the HTTP status mirrors theirs, and the body (httpStatus, latencyMs, success, error) reports the outcome. A 4xx/5xx means their endpoint responded that way, not that this API failed.

## Request body

- WebhookTestRequest
  - `url` string, required — The customer endpoint URL to send a synthetic test event to

## Response `200`

Endpoint returned 2xx.

- WebhookTestResponse
  - `httpStatus` integer — HTTP status returned by the customer endpoint, if any
  - `latencyMs` integer — Round-trip latency in milliseconds
  - `success` boolean — Whether the customer endpoint returned a 2xx response
  - `error` string — Network-level error when no HTTP response was received

## Other responses

- `400` — Invalid request (e.g. malformed URL).
- `401` — Unauthorized - Invalid or missing JWT token
- `403` — Forbidden
- `502` — Endpoint unreachable.
- `4XX` — Endpoint rejected the event.
- `5XX` — Endpoint errored.

---

[API](https://skmtc.net/gonitro/apis/nitro-sign-public-api.md) · [All operations](https://skmtc.net/gonitro/apis/nitro-sign-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gonitro/nitro-sign-public-api/versions/26e3043a365b/schema)