---
title: "Verify a webhook endpoint"
method: POST
path: "/webhooks/{webhookEndpointId}/verify"
tags: ["Webhooks"]
---

# Verify a webhook endpoint

`POST /webhooks/{webhookEndpointId}/verify`

Send a test event to verify the webhook endpoint is properly configured and reachable. The request body accepts an optional 'eventType' field to specify which event type to test (e.g., 'transaction.created', 'transaction.updated'). If omitted from the request body, defaults to 'transaction.created'.

## Path parameters

- `webhookEndpointId` string, uuid, required — ID for the webhook

## Request body

- VerifyWebhookParams — Request body for verifying a webhook endpoint
  - `eventType` 'transaction.created' | 'transaction.updated' | 'checkingAccount.balance.updated' | 'savingsAccount.balance.updated' | 'treasuryAccount.balance.updated' | 'investmentAccount.balance.updated' | 'creditAccount.balance.updated', nullable — Optional event type to test. If not specified, defaults to transaction.created.

## Response `204`

## Other responses

- `400` — Invalid `body`
- `404` — `webhookEndpointId` not found

---

[API](https://skmtc.net/mercurytechnologies/apis/mercury-api.md) · [All operations](https://skmtc.net/mercurytechnologies/apis/mercury-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mercurytechnologies/mercury-api/revisions/0bdf4a496e03/schema)