Skip to content
Statusfield LogoStatusfield

Integrations

Slack

Receive service status notifications in your Slack workspace

On this page

Send selected vendor status changes and recovery updates to the engineering channel responsible for that dependency. This guide covers setup, permissions, delivery checks, and troubleshooting. Check pricing for the plan that includes Slack and the integration capacity you need.

Overview

Statusfield supports two types of Slack integration:

  1. OAuth Channels (Recommended) - Connect your Slack workspace and select channels from a list
  2. Incoming Webhooks - Use Slack webhook URLs for simple one-way notifications

Which Method Should I Use?

OAuth lets you connect a workspace and select channels. Use an incoming webhook when your team already manages one for the destination. Workspace policy may require an administrator to approve either method.

Quick Start: OAuth Channels

1

Connect Your Slack Workspace

  1. Go to statusfield.com/integrations
  2. Click the Slack card
  3. Click Connect Slack button
  4. Select your Slack workspace
  5. Click Allow to grant Statusfield permissions

Permissions

Statusfield requests permission to:

  • View channel names and topics
  • Post messages to channels you select
  • No access to message history or DMs
2

Add a Channel

After connecting:

  1. Click Add Slack Integration button in the manage drawer
  2. Select "Add Channel" option
  3. Select desired channel from the list
  4. Click Add Channel button
  5. You can edit the channel name later in the manage drawer

You can add multiple channels and configure each one independently.

3

Test It Out

  1. Click the menu (⋮) next to your Slack integration
  2. Select the Test action
  3. Check that the test message appears in your Slack channel
4

Configure Notifications

When adding a monitor for a service:

  1. Go to statusfield.com/notifications
  2. Find the service in the list
  3. Configure when you want to receive notifications (status by column)
  • On any status change
  • On maintenance status
  • On degraded status
  • On major outage status
  • On partial outage status

A destination alerted about an incident also receives its recovery while the destination and alert rule remain active. Use Recovery only for destinations that only need the all-clear.

Quick Start: Slack Webhooks

1

Create a Slack Webhook

In your Slack workspace:

  1. Go to https://api.slack.com/apps
  2. Click Create New App > From scratch
  3. Name it "Statusfield" and select your workspace
  4. Navigate to Slack Features > Incoming Webhooks and toggle it on
  5. Click Add New Webhook
  6. Select the channel
  7. Copy the webhook URL (starts with https://hooks.slack.com/...)
2

Add Webhook to Statusfield

  1. Go to statusfield.com/integrations
  2. Click the Slack card
  3. Click Add Slack Integration button
  4. Select "Slack Webhook" option
  5. Enter a name (e.g., "#engineering-alerts")
  6. Paste the webhook URL
  7. Click Add Webhook button
3

Test It Out

  1. Click the menu (⋮) next to your Slack integration
  2. Select the Test action
  3. Check that the test message appears in your Slack channel

Slack Message Format

Each Slack notification includes:

  • Service name - Clear identification (e.g., "🔴 GitHub")
  • Status level - Current status with emoji indicator
    • 🟢 Operational
    • 🟡 Degraded
    • 🟠 Partial Outage
    • 🔴 Major Outage
    • 🔵 Maintenance
  • Affected components - List of impacted components
  • Status-change context - Details available for the detected update; vendor incident information is included when available
  • Link - Button linking to full incident details on Statusfield

Managing OAuth Connections

View Connected Workspace

In the Slack integrations drawer, you'll see:

  • Connected workspace name (e.g., "Connected to Acme Corp workspace")

Disconnect Workspace

To disconnect your Slack workspace:

  1. Open statusfield.com/integrations > Slack
  2. Click Disconnect next to the connected workspace
  3. Confirm the action

Warning

Disconnecting removes all OAuth channels and their notification rules. Everything is deleted. Webhooks are not affected.

Reconnect After Disconnection

If you disconnected or revoked access:

  1. Click Connect Slack again
  2. Authorize the workspace
  3. Re-add your channels

Your previous notification configuration won't be restored automatically.

Choose the updates your channel needs

For a deployment channel, add GitHub and open its Overview from Monitors. Under Monitored components, choose Add or remove (or Pick components for an empty selection), switch to Only the components I choose, select Actions, and click Save. Then assign the relevant notification rules to that channel. Component availability varies by vendor. Keep your application monitoring and incident runbook alongside reported vendor status.

A labeled test confirms delivery to this destination; it is not a vendor incident. Check the channel itself after sending the test. Review the engineering workflow or quickstart for the full setup path.

Troubleshooting

  • App approval required: ask a Slack workspace administrator to approve the installation.
  • Private channel missing: invite the Statusfield app to the channel. Reconnect if the token predates private-channel permissions.
  • Test fails: confirm the integration is active, check the displayed error, and retry after correcting the connection or webhook.
  • Test arrives but incident updates do not: verify the monitor's notification rules, selected components, active plan and allowed channel. There may be no matching status change.

Not Receiving Slack Notifications?

Common issues and solutions:

1. OAuth Connection Expired

Security & Privacy

Permissions

Statusfield's Slack app requests minimal permissions:

  • channels:read - View public channel names
  • groups:read - View private channel names (if invited)
  • chat:write - Post messages to selected channels
  • channels:join - Join public channels used for notifications

We never access:

  • Message history or content
  • Direct messages
  • Files or attachments

Data Protection

  • OAuth tokens are encrypted in our database
  • Tokens are only used to post notifications, nothing else
  • Webhook URLs are stored securely
  • All Slack API calls use HTTPS

Need Help?

Contact our support team at support@statusfield.com