---
title: "Fire a test event to the webhook"
method: POST
path: "/v1/webhooks/{id}/test"
tags: ["Webhooks"]
---

# Fire a test event to the webhook

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

## Request

- Base URL: `https://api.predictasiax.com`
- URL: `https://api.predictasiax.com/v1/webhooks/{id}/test`
- Auth: HTTP bearer

Enqueue a synthetic delivery with is_test_event=true and event_type from the request body (default test.ping). Delivered synchronously; response includes the HTTP status your endpoint returned. Scope: builder:apps:write.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `event_type` string: Any string; not restricted to the catalog for test fires.
  - `data` object: Optional custom payload data (default: standard test note).

## Response `200`

Test event fired

- object
  - `data` object
    - `delivery_id` string
    - `status` 'delivered' | 'failed' | 'pending'
    - `response_status` integer, nullable
  - `meta` object
    - `ts_ms` integer
    - `trace_id` string

## Other responses

- `404`: webhook not found

---

[API](https://skmtc.dev/predictasiax/apis/predictasiax-network-api.md) · [All operations](https://skmtc.dev/predictasiax/apis/predictasiax-network-api/llms.txt) · [OpenAPI document](https://skmtc.dev/predictasiax/apis/predictasiax-network-api/revisions/c2ed1a03ce79?raw)