---
title: "Test webhook URL"
method: POST
path: "/api/v1/external/webhooks/test"
tags: ["Webhooks"]
---

# Test webhook URL

`POST /api/v1/external/webhooks/test`

## Request

- Base URL: `https://api.wove.com`
- URL: `https://api.wove.com/api/v1/external/webhooks/test`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/wove/apis/wove-external-api/docs/api/v1/external/webhooks/test/post.ts> (a function with typed inputs; its response is checked against the schema)

Test a webhook URL before creating it.

## Request body

- object
  - `url` string, uri, required: HTTPS URL to test
  - `event` string: Event type to simulate

## Response `200`

Test completed successfully

- object
  - `success` boolean
  - `data` object
    - `message` string
    - `payload` object: The test payload that was sent

## Other responses

- `400`: Invalid URL or test failed

---

[API](https://skmtc.dev/wove/apis/wove-external-api.md) - [All operations](https://skmtc.dev/wove/apis/wove-external-api/llms.txt) - [OpenAPI document](https://skmtc.dev/wove/apis/wove-external-api/revisions/37290e267e07?raw)