Skip to main content

Slack Integration

Connect your Knak account to Slack to receive real-time notifications and collaborate on assets directly within your Slack workspace.

Updated over 2 weeks ago

Overview

The Slack integration allows you to:

  • Get asset activity updates in Slack

  • Mention teammates in Knak and notify them in Slack

  • Link Knak users to their Slack accounts for seamless collaboration

Note: Only users with Integration Creation Permissions can set up the company-wide Slack integration.


How to Connect Slack to Knak

Step 1: Go to the Admin Panel

  • Click the Admin button in the top-left corner.

  • Open the Integrations section. Click the Platforms tab.

Platforms page on the admin side of the platform

Step 2: Find Collaboration Tools

  • Scroll down to the Collaboration section

  • Click Connect next to the Slack integration

  • If it says “Reconnect,” the integration was previously connected

Collaboration section of the platform selection page with red box around connect button

Step 3: Authorize Slack

  • Complete the authorization flow

  • Choose the Slack workspace used by your Knak team

Step 4: Confirm Linking

  • After authorization, you’ll return to the same page

  • Users with matching email addresses in Knak and Slack will be linked automatically

Step 5: Verify Connection

  • The button now displays Reconnect

Slack integration tile showing “Reconnect” status

Step 6: Turn On Slack Notifications

  • Click your profile icon at the top right of the Studio page

  • Click Manage Notifications

    Manage notifications option from profile menu
  • Enable Slack notifications from the options shown

    Slack notifications toggled on

Step 7: Start Collaborating

  • Tag someone in a Knak asset comment.

  • They should receive a Slack notification.


Optional: Link Individual Slack Account

Use this only if your Slack email address is different from your Knak email.

  1. Ensure company-wide Slack integration is set up (Steps 1–4 above)

  2. Go to Manage Profile

  3. Scroll to Link Slack User

    • Button will say Re-link if already connected

  4. Complete the auth flow

    • You’ll return to your profile page after linking

Once linked, you’ll receive Slack notifications from Knak.


What the Integration Does

This integration makes Knak asset collaboration fast and centralized inside your Slack workspace.

Asset Collaboration & Notifications

  • Posts updates to a #knak-assets Slack channel when emails or landing pages are created or changed

  • Includes asset details (name, status, assigned user, campaign, preview image)

  • Interactive buttons to Open, view Details, and check Approvals

  • Sends threaded Slack messages for asset status changes or comments

User Linking & Authentication

  • Links Slack and Knak accounts using a secure OAuth flow

  • Supports both company-wide bot tokens and individual user tokens

  • Automatically maps user mentions (e.g., @username) across platforms

Comment Synchronization

  • Knak comments appear in corresponding Slack threads

  • Slack mentions and formatting are converted for Knak compatibility

  • Supports cross-platform replies and mentions

Release & System Notifications

  • Sends release notes and deployment updates to Slack via GitHub Actions

  • Posts alerts for database issues, feature flags, and canary deployments

Interactive Actions

  • Lets users take actions from Slack (view, comment, approve assets)

  • Displays fallback if user accounts aren’t yet linked

Watch this video to see the Slack Integration in action!


Troubleshooting

Issue - Not All Users Can Enable Slack Notifications

1. Check Slack App Distribution

Ask your Slack admin to:

  • Go to Slack → Manage Apps → Knak → App Info → Distribution

  • Make sure it says Approved or Installed to entire workspace

    • If it says “Installed by [person],” the app is not globally available

2. Verify App Management Settings

In Slack App Management Settings, ensure:

  • Knak is listed under Approved Apps

  • Members are allowed to connect approved apps

If both are true, users should be able to click Link Slack in Knak without errors.

Recommended Next Steps

Step 1. Allow or Pre-Approve Knak App Authorization

Choose one of the following:

  • Allow all members to authorize apps

  • Pre-approve the Knak app so users can link without admin help

  • Manually whitelist users if rollout needs to be limited

Step 2. Have Users Retry the Link

  • Go to Manage Profile → Link Slack User

  • Complete the Slack OAuth

  • Check for a “Linked” status or a Slack ID

Step 3. Test the Integration

  • Tag the user in a Collaborate comment

  • Confirm they receive a Slack DM

  • If not, check their Slack ID and workspace alignment


Need more help? Contact support via live chat using the chat bubble in the bottom right corner or email support@knak.com.

Did this answer your question?