---
title: "Test a webhook"
method: POST
path: "/tenants/{tenantId}/webhooks/{webhookId}/test"
tags: ["Webhooks"]
---

# Test a webhook

`POST /tenants/{tenantId}/webhooks/{webhookId}/test`

Send a test payload to your webhook endpoint and verify it receives the data correctly.

Use this to:
- Verify your webhook URL is accessible
- Test your signature verification code
- Ensure your server handles the payload format correctly

**Test payload format:**
The test payload is identical to real webhook payloads, containing sample data
for the specified event type. Your webhook should respond with a 2xx status code.

## Path parameters

- `tenantId` string, required
- `webhookId` string, required

## Request body

- object
  - `event` 'MessageSent' | 'MessageDelayed' | 'MessageDeliveryFailed' | 'MessageHeld' | 'MessageBounced' | 'MessageLinkClicked' | 'MessageLoaded' | 'DomainDNSError', required — Event type to simulate

## Response `200`

Test result

- WebhookTestResponse
  - `success` true, required
  - `data` object, required
    - `success` boolean, required — Whether the webhook endpoint responded with a 2xx status
    - `statusCode` integer, nullable, required — HTTP status code from the webhook endpoint
    - `body` string, nullable — Response body from the webhook endpoint (truncated if too long)
    - `error` string, nullable — Error message if the request failed
    - `duration` integer, required — Request duration in milliseconds
    - `event` string, required — Event type that was tested
  - `meta` ApiMeta, required
    - `requestId` string, required — Unique request identifier for debugging and support

## Other responses

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

---

[API](https://skmtc.net/arkhq-io/apis/ark-email-api.md) · [All operations](https://skmtc.net/arkhq-io/apis/ark-email-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/arkhq-io/ark-email-api/revisions/98a90852ffca/schema)