Integrations overview
Everything you do in the HostTracker app can also be done from your own tools. All of the surfaces below sit on one
REST API v2 and use one kind of credential: an API token you mint at
Integrations -> API (/integrations/api), or an OAuth sign-in for AI assistants.
Pick the right tool
Section titled “Pick the right tool”| You want to… | Use | Page |
|---|---|---|
| Call HostTracker from your own code in any language | REST API v2 (182 operations) | REST API v2 |
| Skip hand-written HTTP in TypeScript, Python, Go or .NET | Official SDKs | Official SDKs |
| Work from a terminal or a CI script | ht-cli |
ht-cli |
| Let Claude, ChatGPT, Cursor or another AI assistant operate your account | MCP server (65 tools) | MCP server |
| Keep monitors, contacts, maintenance and status pages in version control | Terraform provider | Terraform provider |
| Smoke-test a deploy from GitHub Actions | HostTracker Check action | GitHub Action |
| Receive events (down, up, incidents, expiry, changes) at your own endpoint | v2 webhooks | Webhooks |
| Send alerts to Slack, Teams, PagerDuty and other services | Alert contacts (set up in the app) | Alert channels |
Requirements
Section titled “Requirements”- API access on your plan. API access is a plan feature (Business and Enterprise include it) - see which plans include the API.
- A token with the right scopes. Scopes are per area (
monitor,contact,subs,webhook,statuspage,account,check) with separate read and write leaves. See API authentication, tokens and scopes. - Quotas. Each scope has per-minute and per-month call windows; see Rate limits and quotas.
Conventions that hold everywhere
Section titled “Conventions that hold everywhere”- Base URL
https://api2.host-tracker.com, headerAuthorization: Bearer <token>. - Every timestamp is Unix seconds; monitor
intervalis in seconds. - Errors are RFC 9457 problem documents with a stable
code- see Error codes. - Lists are cursor-paged (
limit+cursor,nextCursor/hasMore). - Writes accept an
Idempotency-Keyso retries are safe; some require one. - Bulk operations and report generation return a job to poll.
Reference material
Section titled “Reference material”- Interactive API reference - every endpoint with its schema.
- OpenAPI 3.1 document:
https://api2.host-tracker.com/openapi/v2.json(an OpenAPI 3.0 twin is in the HostTracker/openapi repository). - Public source for the SDKs, CLI, Terraform provider, GitHub Action and MCP server: github.com/HostTracker.