---
title: "Changes to Create a URL monitor"
method: POST
path: "/v1/checks/url"
---

# Changes to Create a URL monitor

`POST /v1/checks/url`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 2 of 4 revisions.

- **2026-08-12** `87d29dc7b4fe` — 18 breaking, 4 warning, 36 info
- **2026-08-05** `9e903da4f3da` — 2 info

## Changes

- **2026-08-12** `87d29dc7b4fe` — 18 breaking, 4 warning, 36 info
  - request body became required
  - for the `header` request parameter `x-checkly-account`, the type/format was changed from `string`/`` to `string`/`uuid`
  - the `name` request property's minLength was increased from `0` to `1`
  - the `privateLocations/items/` request property's minLength was increased from `0` to `1`
  - the `request/url` request property's minLength was increased from `0` to `1`
  - the `tags/items/` request property's minLength was increased from `0` to `1`
  - the `triggerIncident/serviceId` request property's minLength was increased from `0` to `1`
  - the `alertSettings/parallelRunFailureThreshold/percentage` request property type/format changed from `number`/`` to `integer`/``
  - the `alertSettings/reminders/amount` request property type/format changed from `number`/`` to `integer`/``
  - the `alertSettings/reminders/interval` request property type/format changed from `number`/`` to `integer`/``
  - the `alertSettings/runBasedEscalation/failedRunThreshold` request property type/format changed from `number`/`` to `integer`/``
  - the `alertSettings/timeBasedEscalation/minutesFailingThreshold` request property type/format changed from `number`/`` to `integer`/``
  - the `triggerIncident/serviceId` request property type/format changed from `string`/`` to `string`/`uuid`
  - the response property `alertChannels/email/items/address` became optional for the status `201`
  - the response property `alertChannels/slack/items/url` became optional for the status `201`
  - the response property `alertChannels/sms/items/number` became optional for the status `201`
  - the response property `alertChannels/webhook/items/url` became optional for the status `201`
  - the `created_at` response's property type/format changed from `string`/`date` to `string`/`date-time` for status `201`
  - removed the optional property `attributes` from the response with the `401` status
  - removed the optional property `attributes` from the response with the `402` status
  - removed the optional property `attributes` from the response with the `429` status
  - added the new `undefined` enum value to the `runtimeId` response property for the response status `201`
  - added the new optional request property `checkType`
  - the `assertions` request property default value `` was added
  - the `locations` request property default value `` was added
  - the `tags` request property default value `` was added
  - the `activated` request property default value `true` was removed
  - the `url` request property default value `https://api.checklyhq.com` was removed
  - added the new `undefined` enum value to the request property `runtimeId`
  - the `description` request property's maxLength was increased from `500` to `510`
  - added the non-success response with the status `400`
  - the response property `message` became required for the status `401`
  - the response property `message` became required for the status `402`
  - the response property `message` became required for the status `403`
  - the response property `message` became required for the status `429`
  - the `assertions` response's property default value `` was added for the status `201`
  - the `headers` response's property default value `` was added for the status `201`
  - the `locations` response's property default value `` was added for the status `201`
  - the `queryParameters` response's property default value `` was added for the status `201`
  - the `tags` response's property default value `` was added for the status `201`
  - …18 more
- **2026-08-05** `9e903da4f3da` — 2 info
  - the `degradedResponseTime` request property's max was increased from `30000.00` to `45000.00`
  - the `maxResponseTime` request property's max was increased from `30000.00` to `45000.00`

---

[Operation](https://skmtc.dev/checklyhq/apis/checkly-public-api/docs/v1/checks/url/post.md) · [API](https://skmtc.dev/checklyhq/apis/checkly-public-api.md) · [Page](https://skmtc.dev/checklyhq/apis/checkly-public-api/changes/v1/checks/url/post)