---
title: Slack Integration
description: Connect Slack to receive build notifications directly in your team's channel. Slack integration is available on Pro plans.
---

Connect Slack to receive build notifications directly in your team's channel.

<Note>
Slack integration is available on Pro plans.
</Note>

## Setting Up Slack

<Steps>
  <Step title="Create a Slack webhook">
    In Slack:
    1. Go to your workspace settings
    2. Navigate to **Apps** → **Incoming Webhooks**
    3. Click **Add to Slack**
    4. Choose a channel
    5. Copy the webhook URL
  </Step>
  <Step title="Add to Jamdesk">
    In your Jamdesk project:
    1. Go to **Settings** → **Integrations**
    2. Click **Connect Slack**
    3. Paste your webhook URL
    4. Click **Save**
  </Step>
  <Step title="Test the connection">
    Click **Send Test** to verify the integration works.
  </Step>
</Steps>

## Notification Preferences

Choose which build outcomes trigger notifications:

| Event | Default | Description |
|-------|---------|-------------|
| Build succeeded | On | Notifies when a build completes successfully |
| Build failed | On | Notifies when a build fails |

Both are enabled by default. To change preferences after setup, toggle the checkboxes and click **Update**.

## Message Format

Notifications include:

- Project name
- Build status
- Commit message and author
- Link to build details
- Duration (for completed builds)

Example:
``` text
✓ Docs build succeeded
Project: My Docs
Commit: "Add authentication guide" by @username
Duration: 45s
View build →
```

## Removing Slack

To disconnect:

1. Go to **Settings** → **Integrations**
2. Click **Disconnect** next to Slack
3. Confirm the removal

## Troubleshooting

<Accordion title="Notifications not appearing">
  1. Check the webhook URL is correct
  2. Verify the channel still exists
  3. Send a test notification
  4. Check Slack's incoming webhook settings
</Accordion>

<Accordion title="Changed preferences not saving">
  After toggling notification checkboxes, click the **Update** button that appears. Changes are not saved automatically.
</Accordion>

## Related Articles

<Columns cols={2}>
  <Card title="Monitoring Builds" icon="chart-line" href="/builds/monitoring">
    Track builds in the dashboard
  </Card>
  <Card title="Slack Issues" icon="wrench" href="/help/troubleshooting/slack-issues">
    Troubleshoot Slack problems
  </Card>
</Columns>