Create website monitoring and notifications

Configure website monitoring and receive notifications for issues. You can set the check frequency, method (e.g., GET, expected status codes), and notification preferences (e.g., email).

VPS Services VM

Context

Path Parameters

id string required Example: url-monitors

id parameter

Headers

Accept Example
Content-Type Example

Body

required
application/json
alert_channels array · Example: ["email"]
check_interval integer · Example: 300
check_ssl boolean · Example: false
consecutive_failures integer · Example: 2
description string · Example:
endpoint_id integer · Example: 67
expected_status_codes array · Example: [200]
max_response_time integer · Example: 3000
method string · Example: GET
name string · Example: Anna Svensson
search_string string · Example:
ssl_alert_days integer · Example: 14
timeout integer · Example: 30
type string · Example: cpu
url string · Example: https://www.example.com

Responses

200
data object required
data.message string required · Example: URL monitor created successfully

Human-readable message.

data.monitorId integer · Example: 53
data.success boolean · Example: true

True for successful responses.

requestId string required · Example: 2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba

Unique request identifier (UUID).

success boolean required · Example: true

True for successful responses.

timestamp string required · Example: 2026-02-10T00:00:00.000Z

ISO 8601 timestamp (UTC).

400
code string required · Example: BAD_REQUEST

Machine-readable error code.

error string required · Example: Bad Request

HTTP status title (e.g. 'Bad Request').

message string required · Example: url has invalid format

Human-readable message.

requestId string required · Example: 2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba

Unique request identifier (UUID).

timestamp string required · Example: 2026-02-10T00:00:00.000Z

ISO 8601 timestamp (UTC).

403
code string required · Example: FORBIDDEN

Machine-readable error code.

error string required · Example: Forbidden

HTTP status title (e.g. 'Bad Request').

message string required · Example: Du kan bara övervaka URL:er för domäner du äger. Hostname 'www.example.com' matchar ing...

Human-readable message.

requestId string required · Example: 2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba

Unique request identifier (UUID).

timestamp string required · Example: 2026-02-10T00:00:00.000Z

ISO 8601 timestamp (UTC).

POST https://cloud.hostup.se/api/notifications/{id}
For AI assistants
cURL 
curl -X POST "https://cloud.hostup.se/api/notifications/url-monitors" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.example.com",
    "name": "Anna Svensson",
    "description": "",
    "check_interval": 300,
    "timeout": 30,
    "max_response_time": 3000,
    "consecutive_failures": 2,
    "method": "GET",
    "expected_status_codes": [
      200
    ],
    "search_string": "",
    "check_ssl": false,
    "ssl_alert_days": 14,
    "alert_channels": [
      "email"
    ]
  }'
Response 
{
  "success": true,
  "timestamp": "2026-02-10T00:00:00.000Z",
  "requestId": "2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba",
  "data": {
    "message": "URL monitor created successfully",
    "monitorId": 53
  }
}
Request Body Example 1 
{
  "url": "https://www.example.com",
  "name": "Anna Svensson",
  "description": "",
  "check_interval": 300,
  "timeout": 30,
  "max_response_time": 3000,
  "consecutive_failures": 2,
  "method": "GET",
  "expected_status_codes": [
    200
  ],
  "search_string": "",
  "check_ssl": false,
  "ssl_alert_days": 14,
  "alert_channels": [
    "email"
  ]
}