Skip to content
Slipwaydocs

Slack

Notifications and interactive approvals in Slack channels.

At a glance

Section titled “At a glance”
Category Notifications
Authentication Slack app (OAuth)
Provider id slack

What it does

Section titled “What it does”
  • Channel notifications
  • Approve and reject buttons that record a decision with channel slack
  • Thread updates as a deployment progresses

Set up

Section titled “Set up”
  1. Open Settings, Integrations, Slack and choose Add to Slack.
  2. Pick the workspace and grant the requested scopes.
  3. Create a subscription and choose the channel and events.
  4. Click Send test. For approvals, make sure approvers have linked their Slack identity in profile settings.

Configuration

Section titled “Configuration”

Illustrative configuration. Non-secret settings are stored as integration config; credentials are stored as encrypted Slipway secrets and referenced by name.

provider: slack
subscription:
  events: [deployment.waiting_approval, deployment.failed, deployment.succeeded]
  channel: "#releases"
  filter: 'environment == "production"'

Notes

Section titled “Notes”

Interactive approvals use the same permission checks as the web UI: the Slack user must map to a Slipway user who is an approver for that environment.

Section titled “Related”