Skip to main content
Better Stack uses two separate API tokens — one for Uptime, one for Telemetry — and you provide whichever you use (at least one). With them the agent can work with your uptime monitors, incidents, and telemetry.

​
Connect

​
Create your tokens

  • Uptime API token — from Better Stack’s Uptime API settings.
  • Telemetry API token — from Better Stack’s Telemetry API settings.

​
Connect in Nuphos

In Connectors → Connect → Better Stack, enter: At least one token is required. Each token you provide is verified against the Better Stack API before saving.

​
Optional extras

  • Dashboard team ID — lets Nuphos deep-link into your Better Stack dashboards.
  • Prometheus webhook URL — point Better Stack’s Alertmanager-style webhook at Nuphos so alerts flow in.

​
In the Nuphos app

Your monitors, heartbeats, and incidents feed the unified Monitoring overview — one place to see uptime and liveness across all your observability providers, with deep links back into Better Stack for the full detail.

​
What the agent can do for you

The agent can list and manage Uptime monitors, heartbeats, and incidents, and read Telemetry dashboards, sources, and metrics. In practice:
  • “Anything down right now?” — it reads monitors and active incidents and summarizes.
  • “Set up an uptime monitor for the new API endpoint” — a change, so it proposes a plan and creates the monitor once you approve.
  • “Why did the heartbeat for the nightly job miss?” — it combines Better Stack signals with what it can see through your other connectors to find the cause.

​
Permissions & authorization

Two boundaries govern what happens through this connector:
  • Hard boundary — who can use it. Only team Administrators can bind or remove the tokens, and they can restrict the binding to specific members with a member allow-list. Within a session the agent only holds credentials you explicitly selected, re-checked on every request.
  • Soft boundary — what the agent may do with it. Reading monitors, incidents, and telemetry is free-form; creating or changing monitors goes through plan approvals and Auto-authorization.
The outer limit is which tokens you provided: give only the Uptime token and the agent can’t touch Telemetry at all, and vice versa.

​
Good to know

  • The two tokens are independent — you can start with one product and add the other later by updating the binding.
  • With the Prometheus webhook configured, Better Stack alerts flow into Nuphos as they fire rather than waiting to be polled.