Get started

You'll create an API key, connect it to your monitoring tool, and install the app. The whole thing takes about five minutes.

Open the Ping tab

Sign in to Kunobi and open your profile — either click your avatar and choose profile, or go straight to kunobi.com?openProfile=true. Select the Ping tab, where you manage API keys and see your registered devices.

Create an API key

Click Create API key and fill in:

Team — who should receive alerts sent with this key. Pick your personal team to page just yourself, or a shared team to page everyone on it. (More in Teams.)
Label — a name you'll recognize later, e.g. grafana-production.
Expiry — 90 days is recommended; you can also choose 30, 60, 365 days, or no expiry.

The key isn't tied to a provider — the same key works with every tool. Which tool an alert comes from is decided by the URL you point it at (more in Providers).

The key's secret is shown once, right after you create it. Copy it somewhere safe before closing the dialog — you can't view it again. If you lose it, just revoke the key and create a new one.

Connect your monitoring tool

In your monitoring tool, add a webhook (contact point / alert channel) that points at Ping's ingestion URL for that tool — the last path segment selects the provider:

https://api.kunobi.ninja/api/webhooks/<provider>

Use /signoz, /grafana, /prometheus, and so on — or /raw for the generic JSON format below. Then authenticate it with the API key you just copied — most tools take it as the password on the webhook, an Authorization: Bearer header, or an x-api-key header. That's it: no other configuration needed.

Under the hood, that's a single HTTP POST. If you'd rather send it yourself — or just want to confirm the pipe works — this is exactly what a producer sends to the generic endpoint:

curl -sS -X POST https://api.kunobi.ninja/api/webhooks/raw \
  -H "Content-Type: application/json" \
  -H "x-api-key: $PING_API_KEY" \
  -d '{"source":"grafana","dedup_key":"checkout-5xx-01","title":"Payments API is down","summary":"Elevated 5xx on checkout","service":"payments-api","severity":"critical"}'

See Connect your monitoring for step-by-step notes on Grafana, SigNoz, Prometheus Alertmanager, and the generic webhook — including the full field reference.

Download the app and sign in

Install Kunobi Ping and sign in with the same email you use for Kunobi — tap the sign-in link we email you, or continue with Google:

Download on theApp Store Get it onGoogle Play

Allow notifications when prompted. Your device registers to your email automatically — there's no code to paste or QR to scan.

You're done

The next time one of your monitors fires, the alert lands on your phone as a push notification and appears in your Ping inbox. Open it to read the full incident and acknowledge it to let your team know it's handled.

Want to be sure it works? Trigger a test alert from your monitoring tool (most have a "Test" button on the contact point). It should arrive within seconds on any signed-in device on that team.

Get started

On this page