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

# Send a test event

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

## Request

- Base URL: `https://hcti.io`
- URL: `https://hcti.io/v1/webhooks/{id}/test`
- Auth: HTTP basic

Queues a webhook_test delivery to an enabled webhook, signed and with its parameters like any other delivery. Each webhook accepts one test every 30 seconds, including the test sent when it is created or its delivery settings change; sooner requests return 429. Disabled webhooks return 400. Returns the event ID; get the delivery's status from the webhook event endpoint.

**Rate limit:** 5 requests per minute per organization, shared across all operations in the `webhook:test` group and all API keys belonging to that organization.

## Path parameters

- `id` string, required

## Response `200`

OK

- WebhookTestEvent: A queued webhook_test delivery.
  - `event_id` string, required: ID of the queued webhook_test event. Get its delivery status with the webhook event endpoint.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `429`: Too Many Requests

## Changes

- **2026-10-30** `146fbf859b2d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/htmlcsstoimage/apis/html-css-to-image-api/changes/v1/webhooks/:id/test/post.md)

---

[API](https://skmtc.dev/htmlcsstoimage/apis/html-css-to-image-api.md) - [All operations](https://skmtc.dev/htmlcsstoimage/apis/html-css-to-image-api/llms.txt) - [OpenAPI document](https://skmtc.dev/htmlcsstoimage/apis/html-css-to-image-api/revisions/100550373ae1?raw)