---
title: "Test webhook endpoint"
method: POST
path: "/webhooks/test"
tags: ["Webhooks"]
---

# Test webhook endpoint

`POST /webhooks/test`

## Request

- Base URL: `https://app.arkova.ai/api/v1`
- URL: `https://app.arkova.ai/api/v1/webhooks/test`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Send a synthetic test event to a webhook endpoint to verify configuration. The payload includes test: true so consumers can distinguish test from real events.

## Request body

- object
  - `endpoint_id` string, uuid, required

## Response `200`

Test delivery result

- object
  - `success` boolean
  - `status_code` integer
  - `response_body` string
  - `event_id` string

## Other responses

- `401`: Authentication required
- `403`: The API key does not hold the `webhooks:manage` scope (`insufficient_scope`).
- `404`: Resource not found

---

[API](https://skmtc.dev/arkova/apis/arkova-verification-api.md) · [All operations](https://skmtc.dev/arkova/apis/arkova-verification-api/llms.txt) · [OpenAPI document](https://skmtc.dev/arkova/apis/arkova-verification-api/revisions/a14858d1efd4?raw)