Skip to main content

Slack Integration

Send incident notifications to Slack channels.

Slack Integration

Send real-time incident notifications, status changes, and drill results to your Slack channels. CrownSync posts Block Kit formatted messages via incoming webhooks — no OAuth scopes or bot tokens required.

No OAuth required

This integration uses Slack incoming webhooks. You do not need to install a Slack app with OAuth permissions or manage bot tokens.

Setup Steps

In Slack

  1. Go to api.slack.com/apps(opens in a new tab) and click Create New App → From scratch.
  2. Name the app (e.g. “CrownSync Alerts”) and select your workspace.
  3. Under Features, click Incoming Webhooks and toggle it on.
  4. Click Add New Webhook to Workspace and select the channel where notifications should appear.
  5. Copy the webhook URL.

In CrownSync

  1. Go to Admin → Integrations → Channels.
  2. Click Add Slack Channel.
  3. Paste the webhook URL you copied from Slack.
  4. Give the channel a label (e.g. “#security-alerts”).
  5. Select which event types should be sent to this channel.
  6. Click Save. CrownSync will send a test message to confirm the connection.

Message Format

CrownSync sends messages using Slack Block Kit, which provides rich formatting:

  • Header block — incident title with severity emoji indicator
  • Section fields — incident reference, playbook name, declared by, and timestamp in two-column layout
  • Actions block— “View Incident” button linking directly to the incident timeline in CrownSync
  • Context block — severity level with colour-coded emoji markers

Supported Events

  • incident.created — new incident declared
  • incident.status_changed — status updated (e.g. containment, eradication)
  • incident.severity_changed — severity escalated or de-escalated
  • incident.resolved — incident closed
  • drill.completed — drill finished with summary results
  • playbook.published — new playbook version published
  • collaborator.invited — external collaborator added

Troubleshooting

  • Messages not appearing: Verify the webhook URL is correct. Check that the Slack app has not been uninstalled from the workspace or removed from the channel.
  • channel_not_found: The webhook is tied to a specific channel. If the channel was renamed or archived, create a new webhook for the current channel.
  • 403 or invalid_token: The webhook URL may have been revoked. Regenerate it in the Slack app settings and update CrownSync.
  • Rate limits: Slack allows approximately one message per second per webhook. CrownSync queues and batches rapid-fire events to stay within limits.

Multiple channels

You can configure multiple Slack channels with different event filters. For example, route critical incidents to #security-alerts and drill completions to #training.

Integration instructions last verified: April 2026

Was this page helpful?