---
title: "Send a test event"
method: POST
path: "/webhooks/deliveries:sendTest"
tags: ["Webhooks"]
---

# Send a test event

`POST /webhooks/deliveries:sendTest`

## Request

- Base URL: `https://api.axilio.ai/api/v1`
- URL: `https://api.axilio.ai/api/v1/webhooks/deliveries:sendTest`
- Auth: API key in header `X-Axilio-Api-Key`
- TypeScript: <https://skmtc.dev/axilioai/apis/axilio-api-2/docs/webhooks/deliveries:sendTest/post.ts> (a function with typed inputs; its response is checked against the schema)

Publishes a simulated event to the caller's organization so an endpoint can be verified end to end. Name an event_type from the catalog to simulate it with that type's sample payload (default webhook.test), and an endpoint_id to deliver to that endpoint only (a missing or wrong-organization id returns 404; an endpoint not subscribed to the type is a validation error rather than a silent no-op). Omit the body to deliver webhook.test to every endpoint subscribed to it. The event is queued, not delivered synchronously; the response carries the event id to look up in the delivery log.

## Request body

- WebhookTestEventRequest: Optional body for sending a test event: pick the event type to simulate and, optionally, one endpoint to deliver to.
  - `endpoint_id` string: Deliver the test event to this endpoint only. It must be subscribed to the event type. Omit to deliver to every endpoint subscribed to the type.
  - `event_type` string: The event type to simulate, from the event-type catalog; the event carries that type's sample payload. Omit for webhook.test.

## Response `202`

Accepted

- WebhookTestEventResponse: Identifies the test event that was published.
  - `endpoint_id` string: The endpoint the test event was aimed at, when one was named in the request.
  - `event_id` string, required: Identifier of the published test event.
  - `event_type` string, required: Event type of the published test event.

## Other responses

- `404`: Not Found
- `422`: Unprocessable Entity
- `500`: Internal Server Error

## Changes

- **2026-10-17** `f732df58a578`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/axilioai/apis/axilio-api-2/changes/webhooks/deliveries:sendTest/post.md)

---

[API](https://skmtc.dev/axilioai/apis/axilio-api-2.md) - [All operations](https://skmtc.dev/axilioai/apis/axilio-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/axilioai/apis/axilio-api-2/revisions/62aa324803a7?raw)