Skip to main content
POST
/
v2
/
monitors
Create a new monitor
curl --request POST \
  --url https://api.kausate.com/v2/monitors \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "kausate_id": "<string>",
  "schedule_cron": "<string>"
}
'
{
  "monitor_id": "550e8400-e29b-41d4-a716-446655440000",
  "kausate_id": "co_de_hrb123456_aachen",
  "company_name": "ACME GmbH",
  "schedule_cron": "0 9 * * *",
  "check_count": 0,
  "is_active": true,
  "created_at": "2025-12-04T10:00:00Z",
  "api_url": "/v2/monitors/550e8400-e29b-41d4-a716-446655440000"
}

Authorizations

​
X-API-Key
string
header
required

Sign up at Kausate.com to get an API key

Body

application/json

Request model for creating a monitor.

​
kausate_id
string
required

Kausate ID of the company to monitor

​
schedule_cron
string
required

Cron expression for monitoring schedule

Response

Monitor created successfully

Response model for monitor endpoints.

​
monitor_id
string<uuid>
required
​
kausate_id
string
required
​
schedule_cron
string
required
​
created_at
string<date-time>
required
​
api_url
string
required

URL to access this monitor

​
company_name
string | null

Company name from company_index

​
check_count
integer
default:0

Number of checks performed

​
last_checked_at
string<date-time> | null

Last check timestamp

​
is_active
boolean
default:true

Whether monitor is active