---
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`.
  - `update_frequency` 'daily' | 'weekly' — How often the monitored company is checked for register updates. Defaults to `weekly` if not provided. Only supported when `entity_type` is `company`. Requests for `person` monitors that include this field are rejected with a validation error. Daily monitors are billed at a premium: 50 credits at creation and 50 credits per month while active, instead of the standard 25.

## 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`.
  - `update_frequency` 'daily' | 'weekly', required — How often the monitored company is checked for register updates. Defaults to `weekly` if not provided. Only supported when `entity_type` is `company`. Requests for `person` monitors that include this field are rejected with a validation error. Daily monitors are billed at a premium: 50 credits at creation and 50 credits per month while active, instead of the standard 25.
  - `disabled` boolean, required — Whether the monitor item is disabled.

## Other responses

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

---

[API](https://skmtc.net/oregister/apis/openregister-api.md) · [All operations](https://skmtc.net/oregister/apis/openregister-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/oregister/openregister-api/versions/d1fcaf6d6ca0/schema)