Overview

Frost integrates with Slack to notify your team when merge protection activates, deactivates, or is overridden. Notifications land in the channels you choose so your team stays in the loop.

1. Install the Slack app

Sign in to Frost and navigate to Settings.
Click Connect Slack. You'll be redirected to Slack's OAuth flow.
Select the workspace you want to connect and authorize Frost.

Once connected, the Slack workspace will appear in your Frost settings. You can disconnect at any time.

2. Subscribe channels to repos

After connecting your workspace, configure which Slack channels receive notifications for which repositories:

Navigate to a repository's Configuration page.
Scroll to the Slack Notifications section.
Select a channel from the dropdown and click Subscribe.

You can subscribe multiple channels to the same repository, or the same channel to multiple repositories.

3. Notification types

Frost sends Slack notifications for the following events:

Protection activated — a scheduled window, daily window, or incident triggered protection.
Protection deactivated — the protection period ended or the incident resolved.
Override used — someone bypassed protection using an override label.

4. Slash commands

Frost also supports Slack slash commands for quick actions:

/frost status — check current protection status across your repos.
/frost help — list available commands.

Troubleshooting

Not receiving notifications? — Ensure the Frost app is invited to the target channel.
Channel not appearing? — Frost lists public channels. For private channels, invite the Frost bot first.
Slash commands not working? — Verify the Slack app is installed for the correct workspace.