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

# Fire Test Webhook

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

Fire a test event at one of the customer's TEST webhooks (#1740, S1).

Free on every tier -- no plan gate, only the test-mode kill-switch. The
named webhook is the only target: trackrouter builds one delivery task for
it and enqueues that, with no fan-out and no disposable subscription.

trackrouter refuses a LIVE webhook id with 409, which is forwarded as-is.

## Path parameters

- `webhook_id` string, required

## Request body

- object, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/trackcourier/apis/trackcourier-io-api.md) · [All operations](https://skmtc.dev/trackcourier/apis/trackcourier-io-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/trackcourier/trackcourier-io-api/revisions/2c7fa1f695ef/schema)