> For the complete documentation index, see [llms.txt](https://docs.pushpulse.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pushpulse.com/integrations/slack-integration.md).
# Slack Integration
### How It Works
When an alert is triggered in PushPulse, a message is posted to any Slack channels you've configured for delivery. As the incident evolves, status updates, notes, and all clears are automatically threaded under the original alert message — keeping communication organized and easy to follow.
Form submissions can also be configured to notify Slack channels, giving your team real-time visibility into incoming reports.
***
### Setup Overview
Getting Slack connected involves three steps:
1. **Authorize the PushPulse Slack app** — connect your Slack workspace via OAuth
2. **Add PushPulse to your channels** — grant the app access to the channels you want to use
3. **Configure delivery** — attach channels to alert templates, individual alerts, or forms
***
### Step 1: Authorize the Slack App
Navigate to **Integrations → Slack** in PushPulse and click **Connect**. You'll be redirected to Slack to authorize the PushPulse app for your workspace. You must be a Slack workspace admin, or have permission to authorize third-party apps, to complete this step.
Once authorized, you'll be returned to PushPulse and the integration will show as connected.
***
### Step 2: Add PushPulse to Your Channels
PushPulse can only deliver to channels where the app has been added. This applies to both public and private channels.
**To add PushPulse to a channel:**
1. Open the channel in Slack
2. Run `/invite @PushPulse` in the message field, or go to **Channel details → Integrations → Add an app**
3. Select **PushPulse** from the app list
> **Private channels:** You must invite PushPulse directly. Depending on your workspace settings, a Slack admin may need to approve the invite.
After adding the app to a channel, return to **Integrations → Slack** in PushPulse and click **Refresh Channels**. Confirm the channel appears and shows as ready for delivery before configuring it.
***
### Step 3: Configure Delivery
#### Notification Templates
To deliver alerts to Slack at the template level — so every alert created from that template notifies the same channel(s) automatically:
1. Go to **Alert Templates** and open or create a template
2. In the **Delivery** section, select one or more Slack channels
3. Save the template
Alerts created from this template will automatically notify the selected channels when triggered.
#### Individual Notifications
You can also select Slack channels when composing a new alert:
1. Start composing an alert
2. In the **Delivery** section, select one or more Slack channels
3. Send the alert
This is useful for one-off alerts where broader or different notification is needed beyond a template's default configuration.
#### Forms
To send a Slack notification when a form is submitted:
1. Go to **Forms** and open or create a form
2. In the form settings, locate the **Send submission notification** section
3. Select one or more Slack channels to notify on submission
4. Save the form
The notification will be sent to the configured channel(s) each time the form is submitted.
***
### What Gets Sent to Slack
| Event | Behavior |
| ---------------- | ----------------------------------------------- |
| Alert triggered | New message posted to configured channel(s) |
| Status update | Threaded reply under the original alert message |
| Note added | Threaded reply under the original alert message |
| All clear issued | Threaded reply under the original alert message |
| Form submitted | New message posted to configured channel(s) |
***
### Troubleshooting
**A channel isn't showing up after I added the app.** Click **Refresh Channels** on the Slack integration page in PushPulse. If the channel still doesn't appear, confirm the PushPulse app was successfully added in Slack and try again.
**I can't invite PushPulse to a private channel.** Your Slack workspace may restrict third-party app access to private channels. Contact your Slack workspace admin to approve the invite or adjust permissions.
**Alerts aren't being delivered to Slack.** Verify that (1) the Slack integration is connected, (2) PushPulse has been added to the target channel, and (3) the channel is selected in the alert template, individual alert, or form configuration.
**The PushPulse app was removed from a channel.** Re-add the app using `/invite @PushPulse` in the channel, refresh channels in PushPulse, and confirm the channel shows as ready.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.pushpulse.com/integrations/slack-integration.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.