---
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. For document webhook events (`document_representation.created` and `document_representation.failed`), you can pass `sample.document_type` to test a specific document type payload.

## 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`.
  - `sample` object — Optional test payload controls. Currently only supports `document_type` for document webhook events.
    - `document_type` string — Specific document type to use when generating example payloads for `document_representation.created` or `document_representation.failed`. If omitted for these events, Terminal49 selects a default document type.

## 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

---

[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/998a27e39c03/schema)