---
title: "Send a test webhook"
method: POST
path: "/endpoints/{id}/test"
tags: ["Endpoints"]
---

# Send a test webhook

`POST /endpoints/{id}/test`

Sends a sample `email.received` event to the endpoint. The request
includes SSRF protection (private IP rejection and DNS pinning).
Rate limited to 4 per minute and 30 per hour (non-exempt).
Successful deliveries and verified-domain endpoints are exempt
from the rate limit.

## Headers

- `Idempotency-Key` string

## Response `200`

Test result

- object
  - `success` true, required
  - `data` object, required
    - `status` integer, required — HTTP status code returned by the endpoint
    - `body` string, required — Response body (truncated to 1000 characters)
    - `signature` string — The signature header value sent (if webhook secret is configured)

## Other responses

- `400` — Invalid request parameters
- `401` — Invalid or missing API key
- `404` — Resource not found
- `429` — Rate limit exceeded

---

[API](https://skmtc.dev/primitive/apis/primitive-api.md) · [All operations](https://skmtc.dev/primitive/apis/primitive-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/primitive/primitive-api/revisions/c2299d28022c/schema)