---
title: "Send a test webhook"
method: POST
path: "/v1/management/webhooks/{webhookId}/test"
tags: ["Webhooks"]
---

# Send a test webhook

`POST /v1/management/webhooks/{webhookId}/test`

## Request

- Base URL: `https://api.tokenlab.sh`
- URL: `https://api.tokenlab.sh/v1/management/webhooks/{webhookId}/test`
- Auth: HTTP bearer

Requires a workspace Management Token (mt-...), created at Dashboard > API > Management Tokens. Send Authorization: Bearer mt-.... Inference API keys (sk-...) and webhook signing secrets (whsec_...) are not accepted. Only the token workspace is accessible. Sends webhook.test through the same signed delivery path. HTTP 200 reports a persisted attempt; inspect outcome and http_status to determine receiver success. Resume a paused endpoint before testing.

## Path parameters

- `webhookId` string, required

## Response `200`

Send a test webhook result

- WebhookDelivery
  - `id` string, required
  - `webhook_id` string, required
  - `delivery_id` string, required
  - `event_type` string, required
  - `outcome` 'delivered' | 'failed', required
  - `http_status` integer, nullable, required
  - `attempts` integer, required
  - `delivered_at` string, date-time, nullable, required
  - `created_at` string, date-time, required

## Other responses

- `400`: Bad Request - Invalid input
- `401`: Unauthorized - Invalid or missing API key
- `403`: Forbidden
- `404`: Webhook not found in this workspace
- `409`: Endpoint quota reached or endpoint paused

---

[API](https://skmtc.dev/tokenlab/apis/tokenlab-ai-gateway.md) · [All operations](https://skmtc.dev/tokenlab/apis/tokenlab-ai-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/tokenlab/apis/tokenlab-ai-gateway/revisions/3208bfbcda22?raw)