Skip to content
Sigtake Academy Start free

How to Set Up Alert Notifications for a Team

Teams decide who owns an alert, channels decide where it's delivered, and the project ties them together. This guide connects the three in about fifteen minutes and ends with a test alert arriving where your team will see it.

How routing works

Every alert names a team. When it fires, Sigtake looks at that team's channels in the alert's project and delivers to each of them, and every member of the team also gets it in the app:

An alert carries a team code. The team's members are notified in the app, and the team's channels in the alert's project deliver it to Slack, Microsoft Teams or email. Alert team_code Team MEMBERS PROJECT CHANNELS In-app, always Slack · Teams · Email An alert carries a team code. The team's members are notified in the app, and the team's channels in the alert's project deliver it to Slack, Microsoft Teams or email. Alert team_code Team MEMBERS PROJECT CHANNELS In-app, always Slack · Teams · Email
The team answers "who". The alert's project answers "which channels". Both have to be set up for an alert to leave the app.

So the setup is four links: people into a team, the team into a project, a channel into that project, and the channel onto the team. The steps below make each one, then test the chain. For the model behind it, see routing alerts by team and how channels work.

Set it up

  1. Create the team and add its members

    Go to Teams, create the team and give it a name people will recognize, such as Payments. Then add the people who should hear about its alerts.

    Sigtake generates a six-character team code, such as K7Q2XD, and shows it on the team's page. Your alerts will use it in the next steps. Operators and admins can do this step.

  2. Add the team to the project

    On the team's page, under Projects, use Add to Project and pick the project its alerts come from, such as Production.

    Repeat for every environment the team covers. A team outside a project can't receive that project's alerts: they're rejected with TEAM_NOT_IN_PROJECT. This step needs an admin.

  3. Create a channel in that project

    Switch to the project in the project switcher, open Channels and use Add Notification Channel. Pick the type:

    • Email: nothing else is required. It goes to the team's members, and you can add internal users or external addresses on top.
    • Slack: the first time, an admin connects your workspace from this form. Then pick the Slack channel. For a private channel, run /invite @Sigtake in it first.
    • Microsoft Teams: paste an incoming webhook URL, created in Teams from the channel's Incoming Webhook connector or a Power Automate HTTP flow.
  4. Attach the channel to the team

    Back on the team's page, under Channels, assign the channel you just created. Channels are listed by project, so you'll see it under the project from step 2.

    This is the link that's easiest to forget. Until it exists the team's page warns that its alerts notify nobody, and the alert only shows up in the app. Attaching channels needs an admin.

  5. Send a test alert

    Use an API key from the same project (API Keys in the sidebar) and send an alert with the team's code:

    curl -X POST https://api.sigtake.com/api/ingest \
      -H "X-Api-Key: $SIGTAKE_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "title": "Test alert: notification setup",
        "severity": "info",
        "source": "setup-check",
        "team_code": "K7Q2XD"
      }'

    A 201 response means the alert was accepted. The full request and response format is in the API docs.

  6. Check it landed, then resolve it

    Within a few seconds the alert should appear in each place you set up: the Slack or Teams channel, the members' inboxes, and the bell icon for every member. Then open the alert in Sigtake and resolve it, so the next real alert with the same title starts a fresh incident.

If the alert didn't arrive

What you seeLikely cause
The request fails with TEAM_NOT_IN_PROJECTThe team isn't in the API key's project. Redo step 2, or use a key from the right project.
The request fails with team code not foundA typo in team_code. Copy it from the team's page.
The alert shows in the app but nowhere elseThe team has no active channel in this project. Check step 4, and that the channel wasn't created in a different project.
One channel got it, another didn'tThat channel is switched off, either entirely or for this team. Both switches are on the team's page and the channel list.
Slack channel missing from the pickerIt's private and the app hasn't been invited. Run /invite @Sigtake in the channel and reload.
The email didn't reach someoneThey aren't a member of the team, or added as an additional user on the email channel.
A second test showed nothing newThe first test is still open, so the second folded into it. Resolve it and send again, or read how deduplication works.

What to set up next

  • A team per area of ownership, so each alert reaches the people who can fix it. Routing by team has patterns that work for small companies.
  • Quieter channels in staging, by adding the same team to your staging project with its own Slack channel.
  • A backup channel, such as email next to Slack, so an alert still lands if one destination breaks.

Set up your first team in fifteen minutes

Free during early access. Unlimited users, teams, alerts and monitors — no credit card.