API reference
POST /monitors
POST /api/v1/monitors adds a website or a competitor price page to your OwlHound account, with the same rules and limits as the dashboard.
Request
POSThttps://owlhound.com/api/v1/monitors
Adds a site (uptime) or a product page whose price to track (price). The same rules and limits apply as in the dashboard, including domain verification on the Free plan.
Key: A full-access key.
| Parameter | Where | What |
|---|---|---|
url | JSON body, required | A public address, such as https://example.com. |
name | JSON body, optional | Up to 80 characters. Defaults to the address's host name. |
kind | JSON body, optional | uptime (the default) or price. |
Example
curl -X POST https://owlhound.com/api/v1/monitors \
-H "Authorization: Bearer $OWLHOUND_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://example.com", "name": "My site", "kind": "uptime"}'Answer:
{"id": 13, "name": "My site", "url": "https://example.com", "kind": "uptime", "status": "active"}| Field | Meaning |
|---|---|
status | active, or paused when the domain still needs verifying on the Free plan and its time to verify has passed. |
Status codes
| Code | When |
|---|---|
401 | The key is missing, wrong or revoked. |
429 | More than 60 requests in a minute with this key. |
201 | Created (success). |
400 | The body isn't JSON, the address isn't a public http(s) address, or the kind isn't uptime or price. |
402 | The account needs an active plan or trial to add monitors. |
403 | The key is read-only, or the plan has no room for another monitor of this kind. |
409 | That domain is registered with OwlHound by another account, or its free trial was already used on another account. |
Other endpoints
List monitors · Get one monitor · Delete a monitor · List incidents. Start at the API reference for keys and limits.
Start watching your site in minutes
Free for up to 10 sites, no card, nothing to install. Read-only access you can revoke at any time — never passwords, never admin access.