---
title: "Test Webhook Endpoint"
method: POST
path: "/webhook_endpoints/{webhook_endpoint_id}/test"
---

# Test Webhook Endpoint

`POST /webhook_endpoints/{webhook_endpoint_id}/test`

Sends a sample event to a webhook endpoint for the authenticated project.

## Path parameters

- `webhook_endpoint_id` string, required

## Request body

- PublicTestEndpointBody
  - `event_type` 'batch.completed' | 'batch.failed' | 'batch.expired' | 'batch.cancelled' | 'response.completed' | 'response.failed' | 'response.cancelled' | 'response.incomplete' | 'eval.run.succeeded' | 'eval.run.failed' | 'eval.run.canceled' | 'fine_tuning.job.succeeded' | 'fine_tuning.job.failed' | 'fine_tuning.job.cancelled' | 'realtime.call.incoming' | 'video.completed' | 'video.failed' | 'safety.alert.created', required

## Response `200`

Success

- WebhookEndpointTestResultResource
  - `object` 'webhook_endpoint.test', required — The object type, which is always webhook_endpoint.test.
  - `webhook_endpoint_id` string, required — The ID of the webhook endpoint that received the test.
  - `event_type` string, required — The event type sent in the test.
  - `status_code` integer, required — The HTTP status code returned by the endpoint.
  - `success` true, required — Whether the test request completed. Always true for returned results; use status_code to determine the endpoint response.

## Changes

- **2026-09-16** `c8bd56db4095` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/openai/apis/openapi/changes/webhook_endpoints/:webhook_endpoint_id/test/post.md)

---

[API](https://skmtc.dev/openai/apis/openapi.md) · [All operations](https://skmtc.dev/openai/apis/openapi/llms.txt) · [OpenAPI document](https://skmtc.dev/openai/apis/openapi/revisions/c8bd56db4095?raw)