5 minutes to your first alert

This is the only page you have to read today. By the end you'll have one real integration being watched and a real change from that integration in your Slack — not a screenshot, an actual alert.

If something on this page doesn't match what you see in the app, it's a bug in the docs, not in your account. Tell us.

What you need before you start

• A signed-in Intello account. If you don't have one yet, create one — it takes 30 seconds.
• A Slack workspace where you can install apps. (You can do email or Teams instead — same flow, swap in step 3.)

That's it. No spec URL, no API token, nothing else.

The five steps

1. Add an integration from the library

   From the left nav open Integrations → Add. Pick something your team actually uses — Stripe, OpenAI, Anthropic, Twilio, the usual suspects. We maintain the spec for ~150 vendors, so you don't have to find a URL.

   If you already know the vendor isn't in the library, jump to Add an integration → Bring your own. The rest of this guide still works.

2. Confirm the defaults

   Intello suggests a name, a sync cadence, and a default severity routing. Don't overthink it — the defaults are the right answer for 90% of teams. You can tune them after you see your first alert.

   Click Save. Intello fetches the current spec and stores it as your baseline. This is the "before" picture; everything that changes from now on is what you'll get alerted about.

3. Connect Slack

   Open Settings → Integrations → Slack. Click Connect. You'll bounce through Slack's OAuth screen, pick a default channel (a #api-changes channel works well — don't dump these into #general), and come back.

4. Force the first sync

   Go back to the integration you added. Click Sync now. Intello checks for changes against the baseline. The first time, you'll usually see "No changes" — that's correct. The baseline is the current state.

   Why force it? So you've seen the loop work end-to-end before you trust it with real changes.

5. Wait for a real change (or fake one)

   Now leave it alone. The next time the vendor ships a real change, you'll get the alert in Slack. For most popular vendors, that's hours to days, not weeks.

   Want to see an alert now? Open the integration, click Demo alert, and we'll send a sample to your connected channel so you can see what the live experience feels like.

You're activated. Now what?

The most useful thing to do next is tune who gets paged for what. Defaults send everything to one channel. In a week you'll wish breaking changes paged on-call and the rest landed in a digest.

That's a five-minute job too.