---
title: "Send a synthetic test delivery to a webhook"
method: POST
path: "/v5/webhooks/test/{webhook_id}"
tags: ["Webhooks"]
---

# Send a synthetic test delivery to a webhook

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

## Request

- Base URL: `https://headlessoracle.com`
- URL: `https://headlessoracle.com/v5/webhooks/test/{webhook_id}`
- Auth: API key in header `X-Oracle-Key`

Fires a single test delivery to the webhook URL. Uses the current market state for the first subscribed MIC. One delivery attempt (no retry). Returns the payload sent.

## Path parameters

- `webhook_id` string, required

## Response `200`

Test delivery result

- object
  - `delivered` boolean
  - `payload_sent` object: The exact webhook payload delivered.
  - `status_code` integer: HTTP status from the webhook endpoint.

## Other responses

- `401`: Missing API key
- `403`: Webhook does not belong to this key
- `404`: Webhook not found

---

[API](https://skmtc.dev/headlessoracle/apis/headless-oracle.md) · [All operations](https://skmtc.dev/headlessoracle/apis/headless-oracle/llms.txt) · [OpenAPI document](https://skmtc.dev/headlessoracle/apis/headless-oracle/revisions/4e82fe332f29?raw)