---
title: "Create a webhook endpoint (returns the secret once)"
method: POST
path: "/api/webhooks/endpoints"
tags: ["webhooks"]
---

# Create a webhook endpoint (returns the secret once)

`POST /api/webhooks/endpoints`

## Request

- Base URL: `https://api.reachmcp.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.reachmcp.com/api/webhooks/endpoints`
- Auth: API key in header `X-API-Key`

## Request body

- WebhookEndpointCreateIn
  - `url` string, required
  - `description` string, nullable
  - `events` string[], required
  - `account_ids` integer[], nullable

## Response `201`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/reachmcp/apis/mcp-reach.md) · [All operations](https://skmtc.dev/reachmcp/apis/mcp-reach/llms.txt) · [OpenAPI document](https://skmtc.dev/reachmcp/apis/mcp-reach/revisions/1a85fdaf3f7c?raw)