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

# Test a webhook

`POST /webhooks/{id}/test`

Send a test payload to the webhook URL to verify it's working correctly

## Path parameters

- `id` string, uuid, required

## Response `200`

Test webhook sent successfully

- TestWebhookResponse — Webhook test execution result
  - `success` boolean, required — Whether the test webhook was delivered successfully
  - `status_code` integer, required — HTTP status code returned by the webhook endpoint
  - `webhook_event_id` string, uuid — ID of the webhook event record
  - `message` string
  - `headers_sent` object — Headers sent with the test webhook request
    - `X-Firma-Event` string
    - `X-Firma-Signature` string
    - `X-Firma-Delivery` string
    - `X-Firma-Signature-Old` string — Only present during grace period after secret rotation

## Other responses

- `401` — Unauthorized - Invalid or missing API key
- `404` — Not Found - Resource does not exist
- `429` — Too Many Requests - Rate limit exceeded

---

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