---
title: "Create webhook monitor item"
method: POST
path: "/v1/monitor"
tags: ["v1"]
---

# Create webhook monitor item

`POST /v1/monitor`

## Request body

- WebhookMonitorItemRequest — Request to create a webhook monitor item.
  - `entity_type` 'company' | 'person', required — Type of the entity to monitor.
  - `entity_id` string, required — For `company` this is the register ID (e.g. `DE-HRB-F1103-267645`). For `person` this is the person UUID.
  - `preferences` WebhookMonitorPreference[], required — Preferences for the entity to monitor. Use `WebhookMonitorCompanyPreference` values when `entity_type` is `company`, and `WebhookMonitorPersonPreference` values when `entity_type` is `person`.

## Response `200`

Success

- WebhookMonitorItem
  - `entity_type` 'company' | 'person', required — Type of the entity to monitor.
  - `entity_id` string, required — For `company` this is the register ID (e.g. `DE-HRB-F1103-267645`). For `person` this is the person UUID.
  - `preferences` WebhookMonitorPreference[], required — Preferences for the entity to monitor. Use `WebhookMonitorCompanyPreference` values when `entity_type` is `company`, and `WebhookMonitorPersonPreference` values when `entity_type` is `person`.
  - `disabled` boolean, required — Whether the monitor item is disabled.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `500` — Internal Server Error

## Changes

- **2026-03-30** `cdea05542fb8` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/oregister/apis/openregister-api/changes/v1/monitor/post.md)

---

[API](https://skmtc.dev/oregister/apis/openregister-api.md) · [All operations](https://skmtc.dev/oregister/apis/openregister-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/oregister/openregister-api/revisions/1aebcb0cae4a/schema)