---
title: "Send test event"
method: POST
path: "/v2/organizations/{organizationId}/webhooks/{endpointId}/test"
tags: ["Webhooks"]
---

# Send test event

`POST /v2/organizations/{organizationId}/webhooks/{endpointId}/test`

## Request

- Base URL: `https://api.pdfs.build`
- URL: `https://api.pdfs.build/v2/organizations/{organizationId}/webhooks/{endpointId}/test`
- Auth: HTTP bearer

Enqueues a `webhook.test` event to this endpoint. The body is optional; a missing or malformed body falls back to the default message. Requires a paid plan.

## Request body

- WebhookTestRequest
  - `message` string: Carried in `data.message` of the test event.

## Response `201`

The queued delivery.

- object
  - `delivery` WebhookDelivery, required
    - `id` string, required: Event id (`evt_...`), also sent as the `webhook-id` header.
    - `endpointId` string, required
    - `eventType` 'render.completed' | 'render.failed' | 'webhook.test', required
    - `status` 'pending' | 'processing' | 'delivered' | 'failed', required
    - `attempts` integer, required
    - `lastResponseStatus` integer, nullable
    - `lastError` string, nullable
    - `createdAt` string, required: UTC, ISO 8601 without a timezone suffix.
    - `deliveredAt` string: UTC, ISO 8601 without a timezone suffix.

## Other responses

- `401`: Missing, invalid or expired API key.
- `403`: `plan_gated` (webhooks need a paid plan) or `organization_scope_mismatch`.
- `404`: `not_found` — no such endpoint in this organization.

---

[API](https://skmtc.dev/pdfs/apis/pdfs-build-api.md) · [All operations](https://skmtc.dev/pdfs/apis/pdfs-build-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pdfs/apis/pdfs-build-api/revisions/1c7340b9521d?raw)