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

# Test a registered webhook

`POST /v2/webhooks/{webhookId}/test-event`

Send a test event to a registered webhook. This is useful for verifying that the webhook endpoint is reachable and correctly configured.

## Path parameters

- `webhookId` string, required

## Headers

- `organization-id` string

## Request body

- CreateWebhookTestEventDto
  - `message` string, required — Message to include in the test event sent to the webhook
  - `eventType` 'IN_PROGRESS' | 'PSV_COMPLETED' | 'CREDENTIALING_COMPLETED' | 'PROVIDER_TERMINATED' | 'FACILITY_NOT_SENT_TO_CREDENTIALING' | 'FACILITY_IN_PROGRESS' | 'FACILITY_DATA_MISSING' | 'FACILITY_OUTREACH_IN_PROGRESS' | 'FACILITY_PSV_COMPLETE_BY_CERTIFYOS' | 'FACILITY_CREDENTIALING_RESTARTED' | 'FACILITY_PSV_READY' | 'FACILITY_CRED_APPROVED' | 'FACILITY_HOLD_FOR_CRED_COMM' | 'FACILITY_CRED_DENIED' | 'FACILITY_TERMINATED' | 'FACILITY_RECREDENTIALING_IN_PROGRESS' | 'FACILITY_TABLED' | 'FACILITY_WITHDRAWN_CANCELLED' | 'FACILITY_NOT_STARTED' | 'PROVIDER_NOT_SENT_TO_CREDENTIALING' | 'PROVIDER_NOT_STARTED' | 'PROVIDER_IN_PROGRESS' | 'PROVIDER_DATA_MISSING' | 'PROVIDER_OUTREACH_IN_PROGRESS' | 'PROVIDER_PSV_COMPLETED' | 'PROVIDER_CREDENTIALING_RESTARTED' | 'PROVIDER_PSV_READY' | 'PROVIDER_CRED_APPROVED' | 'PROVIDER_HOLD_FOR_CRED_COMM' | 'PROVIDER_CRED_DENIED' | 'PROVIDER_RECREDENTIALING_IN_PROGRESS' | 'PROVIDER_TABLED' | 'PROVIDER_WITHDRAWN_CANCELLED' | 'FORM_SUBMISSION_CREATED', required — Event type for the test event sent to the webhook

## Response `201`

Webhook test event sent successfully

- unknown

## Other responses

- `400` — Bad request because the wrong parameters are provided in the request body.
- `401` — Authorization token is missing or invalid.
- `403` — User does not have permission to access this resource.
- `422` — The test event could not be sent using the webhook configuration.

---

[API](https://skmtc.net/certifyos/apis/certifyos-api.md) · [All operations](https://skmtc.net/certifyos/apis/certifyos-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/certifyos/certifyos-api/versions/df08dd00da43/schema)