---
title: Notification Providers
---

InfraKitchen integrates with messaging and notification platforms to keep your team informed about infrastructure events, workflow completions, and resource state changes.

Notification integrations allow InfraKitchen to send alerts and updates directly to the channels your team already uses, so engineers are notified the moment something important happens — without having to poll the dashboard.

## Slack

Integrate **Slack** with **InfraKitchen** to receive real-time notifications about infrastructure events.
This integration allows InfraKitchen to post messages to Slack channels when workflows complete, resources change state, or alerts are triggered.

### Create a Slack App

Follow Slack's official guide to [create an app from app settings](https://docs.slack.dev/app-management/quickstart-app-settings). Create the app **From scratch**, give it a name (e.g. `InfraKitchen`), and select the **Workspace** where the app will be installed.

While creating the app, under **OAuth & Permissions → Scopes → Bot Token Scopes**, add each of the following required scopes:

| OAuth Scope        | Description                                                                        |
| ------------------ | ---------------------------------------------------------------------------------- |
| `channels:read`    | View basic information about public channels in a workspace                        |
| `chat:write`       | Send messages as @InfraKitchen                                                     |
| `groups:read`      | View basic information about private channels that InfraKitchen has been added to  |
| `users:read`       | View people in a workspace                                                         |
| `users:read.email` | View email addresses of people in a workspace                                      |

### Install the App to Your Workspace

Still on the **OAuth & Permissions** page, scroll up to the **OAuth Tokens** section and click <kbd>Install to Workspace</kbd>, then allow the requested permissions. Copy the **Bot User OAuth Token** — it starts with `xoxb-`.

:::warning[Keep your token secure]
The `xoxb-` token grants the app access to your Slack workspace. Treat it like a password — do not commit it to version control or share it publicly.
:::

### Invite the Bot to Channels (Optional)

For InfraKitchen to post to a specific channel, the bot must be a member of that channel: type `/invite @InfraKitchen` (or whatever name you chose for your app) in the channel and confirm the invitation.

This is required for **private channels** and recommended for **public channels** to ensure reliable delivery.

### Add the Credentials to InfraKitchen

InfraKitchen path: `/integrations/slack/setup`

| Field                | Description                                                        |
| -------------------- | ------------------------------------------------------------------ |
| **Integration Name** | A unique name for this integration (e.g., `slack-infra-alerts`)   |
| **Description**      | Brief description of the Slack workspace or channel purpose        |
| **Labels**           | Tags such as `slack`, `notifications`, or `alerts`                 |
| **Bot Token**        | The `xoxb-` token copied from the **OAuth & Permissions** page     |

### Test the Connection

1. Click <kbd>Test Connection</kbd> in the InfraKitchen setup form.
2. InfraKitchen will call the Slack API to verify the token and check that the required scopes are granted.
3. If successful, you will see a confirmation message.
4. If the test fails, verify:

   - The **Bot Token** starts with `xoxb-` and has not been revoked.
   - All five required **Bot Token Scopes** are listed under OAuth & Permissions.
   - The app has been **installed** (not just created) in the target workspace.