> ## Documentation Index
> Fetch the complete documentation index at: https://docs.signa.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Test Webhook Endpoint

> Send a synthetic webhook.test ping (does not affect auto-disable)

## Overview

Sends a synthetic `webhook.test` event through the same signing and retry pipeline as
production deliveries, but a failed test does not count toward auto-disable. Use it to probe an
endpoint without risking your production deliveries getting disabled. This endpoint isn't
billed.

Requires the `portfolios:manage` scope.

<Tip>
  No receiver yet? See
  [Testing deliveries before you have a receiver](/guides/monitoring/webhooks#testing-deliveries-before-you-have-a-receiver)
  for a pattern that lets you inspect real signed deliveries in minutes.
</Tip>

## Path Parameters

<ParamField path="id" type="string" required>Endpoint ID (`whk_*`).</ParamField>

## Response

<ResponseField name="object" type="string">Always `"webhook_test"`.</ResponseField>
<ResponseField name="delivery_attempt_id" type="string">UUID of the new attempt row. Track it via [List Webhook Deliveries](/api-reference/monitoring/webhooks/list-deliveries).</ResponseField>
<ResponseField name="request_id" type="string">Request identifier.</ResponseField>

## Errors

| Status | `type`      | When                                             |
| ------ | ----------- | ------------------------------------------------ |
| 404    | `not_found` | Endpoint doesn't exist or belongs to another org |

## Code Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST "https://api.signa.so/v1/webhooks/whk_2mR8vNkT/test" \
    -H "Authorization: Bearer sig_YOUR_KEY" \
    -H "Idempotency-Key: test-whk-2mR8vNkT-2026-06-12"
  ```

  ```typescript TypeScript theme={null}
  import { Signa } from "@signa-so/sdk";
  const signa = new Signa({ api_key: process.env.SIGNA_API_KEY });

  const result = await signa.webhooks.test("whk_2mR8vNkT");
  console.log(result.delivery_attempt_id);
  ```
</CodeGroup>

<ResponseExample>
  ```json theme={null}
  {
    "object": "webhook_test",
    "delivery_attempt_id": "018f9b2e-0000-7000-8000-000000000030",
    "request_id": "req_5nRvXq2T"
  }
  ```
</ResponseExample>

## Related Endpoints

* [List Webhook Deliveries](/api-reference/monitoring/webhooks/list-deliveries) - confirm the test ping arrived
* [Create Webhook Endpoint](/api-reference/monitoring/webhooks/create) - register a new endpoint