Test Webhook Endpoint

Send a synthetic webhook.test ping (does not auto-disable)

POST /v1/webhooks/{id}/test

cURL

curl -X POST "https://api.signa.so/v1/webhooks/whk_01HK.../test" \
  -H "Authorization: Bearer $SIGNA_API_KEY" \
  -H "Idempotency-Key: test-whk-01HK-2026-06-12"

200

{
  "object": "<string>",
  "delivery_attempt_id": "<string>",
  "request_id": "<string>"
}

Overview

Enqueues a synthetic webhook.test event. The delivery follows the same signing and retry pipeline as production deliveries, but failures do not increment consecutive_failures. Use this to probe a dead endpoint without triggering auto-disable.

This endpoint is not billed (utility-tier).

No receiver yet? See Testing deliveries before you have a receiver for a tunnel / request-bin pattern that lets you inspect real signed deliveries in minutes.

Path Parameters

id · string · required

Endpoint ID (whk_*).

Response

object · string

Always "webhook_test".

delivery_attempt_id · string

UUID of the new attempt row. Track via List Deliveries.

request_id · string

Request identifier.

cURL

curl -X POST "https://api.signa.so/v1/webhooks/whk_01HK.../test" \
  -H "Authorization: Bearer $SIGNA_API_KEY" \
  -H "Idempotency-Key: test-whk-01HK-2026-06-12"