---
title: "Trigger a webhook test delivery"
method: POST
path: "/webhooks/trigger"
tags: ["Webhooks"]
---

# Trigger a webhook test delivery

`POST /webhooks/trigger`

Send a one-time test webhook notification payload to a target HTTPS URL without creating a webhook endpoint.

## Request body

- object
  - `url` string, uri, required — Destination URL for the test webhook delivery. Must be HTTPS.
  - `event` string, required — Webhook event name to use for generating an example payload.
  - `secret` string — Optional secret used to sign the request in `X-T49-Webhook-Signature`.

## Response `200`

Webhook test delivery attempt result

- object
  - `url` string, uri — Destination URL that the test webhook delivery attempted to call.
  - `succeeded` boolean — Whether the webhook delivery attempt was considered successful (HTTP 200, 201, 202, or 204).
  - `error` string, nullable — Error message captured when delivery failed, or `null` when no error occurred.
  - `status_code` integer, nullable — HTTP status code returned by the destination endpoint, or `null` if no response was received.
  - `request_headers` object — Headers sent by Terminal49 with the test webhook request.
  - `request_body` string — Serialized JSON payload delivered to the target URL.
  - `response_headers` object, nullable — Headers returned by the destination endpoint, or `null` when unavailable.
  - `response_body` string, nullable — Raw response body returned by the destination endpoint, or `null` when unavailable.

## Other responses

- `422` — Validation error

## Changes

- **2026-05-20** `3b798d71b259` — 1 warning
  - removed the request property `sample`
- **2026-04-01** `de2595e4b160` — 1 info
  - added the new optional request property `sample`
- **2026-03-24** `b91b987e43a3` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/terminal49/apis/terminal49-api-reference/changes/webhooks/trigger/post.md)

---

[API](https://skmtc.dev/terminal49/apis/terminal49-api-reference.md) · [All operations](https://skmtc.dev/terminal49/apis/terminal49-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/terminal49/terminal49-api-reference/revisions/3b798d71b259/schema)