---
title: "Create a webhook endpoint"
method: POST
path: "/webhook-endpoints"
tags: ["Other"]
---

# Create a webhook endpoint

`POST /webhook-endpoints`

## Request

- Base URL: `https://api.markmesh.com/v1`
- URL: `https://api.markmesh.com/v1/webhook-endpoints`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Register a destination for this organisation's filing events.
The signing secret is generated here and returned on this
response only — store it, it cannot be read back.

## Response `201`

Success

## Other responses

- `401`: API key or session credential missing, invalid, expired, or revoked
- `422`: Validation error — field-level detail in the response body

---

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