REST API

TunnelHQ REST API: create and manage monitors, run on-demand connectivity tests, and read incidents over HTTP with API-key auth and curl examples.

Get started

Introduction — What TunnelHQ is and how monitoring works.
Quick start — Add your first monitor in under five minutes.

Adding monitors

Add a monitor — Paste a config or fill in the details by hand.
VPN protocols — All 11 protocols and the fields each one needs.
Import monitors — Bulk import with AI, or upload .ovpn / .conf files.

How it works

Regions & status — Multi-region probes and how aggregate status is computed.
Incidents — How outages are detected, opened, and resolved.

Developers

REST API — Manage monitors, tests, and incidents over HTTP.
CLI — The thq command-line tool.
MCP server — Drive TunnelHQ from Claude, Cursor, and Windsurf.
Webhooks — Receive monitor.up / monitor.down events.

TunnelHQ home · All documentation