# Slack

Cross-post updates to Slack channels automatically

Connect your Slack workspace to Cushion to automatically cross-post updates to your Slack channels, keeping everyone in the loop without context switching.

## Features

- **Automatic Cross-posting** - Share Cushion updates to Slack channels automatically
- **Always Up-to-date** - Slack messages update when you edit posts in Cushion
- **Resolution Updates** - Thread replies notify when posts are resolved or reopened, including who resolved it and why
- **Channel Selection** - Choose which Slack channels receive updates
- **Rich Formatting** - Posts appear with proper formatting and links back to Cushion

## Adding Cushion to Channels

For Cushion to post and sync messages in a channel, the **Cushion bot must be added to that channel**. This applies to both public and private channels.

To add the Cushion bot to a channel:

1. Open the channel in Slack
2. Click the channel name at the top to open settings
3. Select **Integrations** → **Add apps**
4. Search for and add the **Cushion** app
5. The channel will now appear in Cushion’s channel dropdown

> **Note:** Private channels appear with a lock icon in the channel selector.

## How to Enable

1. Navigate to your team **Settings**
2. Select the **Integrations** tab
3. Click **Enable** next to Slack
4. You’ll be redirected to Slack to authorize the connection
5. Select the workspace you want to connect
6. Choose which channels Cushion can post to

## Permissions Required

When you connect Slack, Cushion requests the following OAuth scopes:

- `channels:read` - View public channels in your workspace
- `channels:history` - Read message history to sync updates
- `groups:read` - View private channels you’re a member of
- `chat:write` - Post messages to channels
- `chat:write.customize` - Customize the bot’s display name and avatar

## Setting Up Automations

After connecting Slack:

1. Go to your channel settings in Cushion
2. Enable **Slack notifications** for the channel
3. Select which Slack channel should receive updates
4. Choose what triggers a cross-post (new posts, comments, etc.)

## Disconnecting

To disconnect Slack:

1. Go to team **Settings** → **Integrations**
2. Click **Disconnect** next to Slack

This removes the connection from Cushion. You may also want to remove the Cushion app from your Slack workspace settings.