---
title: "Create Webhook Config"
method: POST
path: "/admin/settings/webhook"
tags: ["Settings"]
---

# Create Webhook Config

`POST /admin/settings/webhook`

## Request

- Base URL: `https://developer.claimmind.life` (the document declares no server; this is the origin it was published from)
- URL: `https://developer.claimmind.life/admin/settings/webhook`
- Auth: OAuth 2
  - Password
  - Token URL: `token`

Create webhook configuration.
Returns the webhook secret (only shown once).

## Query parameters

- `tenant_id` string, nullable: Tenant ID

## Request body

- WebhookConfigUpdate: Webhook configuration update request (full update).
  - `enabled` boolean, required
  - `url` string, required
  - `events` WebhookEvent[], required
  - `secret` string, nullable

## Response `201`

Successful Response

- WebhookConfigResponse: Webhook configuration response.
  - `enabled` boolean, required
  - `url` string, nullable
  - `events` WebhookEvent[], nullable
  - `secret` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/claimmind/apis/claimmind-open-api-service.md) - [All operations](https://skmtc.dev/claimmind/apis/claimmind-open-api-service/llms.txt) - [OpenAPI document](https://skmtc.dev/claimmind/apis/claimmind-open-api-service/revisions/ee8bfbeadb8a?raw)