Create Website Monitor
hudu_create_websiteCreate a website monitor that polls a host for uptime, TLS expiry, WHOIS registration, and DNS changes, and alerts the owning company when checks fail.
Instructions
Create a website monitor. A website in Hudu is a live monitor, not a documentation page: Hudu polls the host on a schedule and records its uptime, TLS certificate expiry, WHOIS registration and DNS records against the owning company.
This is not a passive documentation record. From the moment it is created, the Hudu instance begins making repeated outbound requests to the host you name — HTTP polling plus TLS, WHOIS and DNS lookups — on Hudu's own schedule, and will raise alerts against the owning company when they fail. Point it only at hosts the customer actually owns or is contracted to watch, and use disable_ssl, disable_whois and disable_dns to turn off individual checks that would only produce noise. paused: true creates the record with every check dormant.
Hudu publishes no success response for this endpoint, so the created record may come back empty even though the write succeeded. When that happens this tool returns website: null — confirm with hudu_list_websites filtered by name rather than retrying, which would create a second monitor. Hudu answers 422 with the offending field named when validation fails.
Operation class: Create. Impact: Starts recurring outbound monitoring of an external host from the Hudu instance, and arms the alerts that go with it.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | The site to monitor, written as its URL — "https://portal.contoso.com". This is the host Hudu will begin polling, and it doubles as the display name of the record. | |
| notes | No | Free-text notes shown on the website record, e.g. who owns the domain renewal. | |
| paused | No | true suspends monitoring of this host entirely — no uptime, TLS, WHOIS or DNS checks run and no alerts fire — while keeping the record and its history. This is the right setting for a planned outage or a decommissioning in progress; deleting the record throws away the history as well. | |
| company_id | No | Numeric id of the company this monitor belongs to, so its results appear on that company's page. Resolve a customer name to an id with hudu_list_companies first. The list endpoint has no company filter, so a website that is filed under the wrong company is awkward to find again. | |
| disable_dns | No | true stops DNS record monitoring, so Hudu no longer snapshots the domain's records or reports when they change. Uptime checking continues. | |
| disable_ssl | No | true stops TLS certificate monitoring, so Hudu no longer tracks the host's certificate or warns before it expires. Uptime checking continues. Set this for hosts served over plain HTTP or behind a certificate Hudu cannot validate, where the check would only produce noise. | |
| disable_whois | No | true stops WHOIS monitoring, so Hudu no longer tracks the domain registration or warns before the domain expires. Uptime checking continues. Set this for hosts on a domain the customer does not own, or on a TLD whose registry does not answer WHOIS. |