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

# Send a test event to a webhook

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

Send a test event to the webhook's endpoint and report the outcome.
Use this to verify the endpoint is reachable and accepts deliveries
before subscribing the webhook to real events.

A 200 response means the test ran — check `status_code` and
`error_message` in the body for the endpoint's actual outcome.

Test deliveries are not supported for `HMAC_SHA256` webhooks; those
requests fail with a 400.

<Warning>This endpoint is in alpha, read more [here](https://arize.com/docs/ax/rest-reference#api-version-stages).</Warning>

## Path parameters

- `webhook_id` string, required — A universally unique identifier (base64-encoded opaque string).

## Response `200`

The outcome of the test delivery

- TestWebhookResponse — The outcome of a test delivery to the webhook's endpoint.
  - `status_code` integer, required — HTTP status code returned by the webhook's endpoint. `502` when no response was received, for example because the endpoint was unreachable or timed out.
  - `error_message` string, nullable, required — Why the test delivery failed. `null` for successful deliveries.

## Other responses

- `400` — Invalid request
- `401` — Authentication is required
- `403` — Insufficient permissions to access this resource
- `404` — Not found
- `429` — Rate limit exceeded

---

[API](https://skmtc.net/arize-ai/apis/arize-rest-api.md) · [All operations](https://skmtc.net/arize-ai/apis/arize-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/arize-ai/arize-rest-api/revisions/4d95080d8ffb/schema)