Skip to content
Latchkey
Documentation menu

Slack integration

Connect Latchkey to a Slack channel with OAuth, choose what gets posted, and test the connection.

The Slack integration posts Latchkey notifications into a channel your team already watches. Setup is a one-time OAuth flow done by a workspace owner or admin.

Connecting#

Open Settings, Notifications

The Slack Integration card sits alongside the notification preferences. It is manageable by owners and admins.

Click Add to Slack

You are sent to Slack to authorize Latchkey and pick the channel during the authorization itself; there are no webhook URLs to copy and paste. Slack returns you to the settings page when done.

Confirm the connection

The card now shows Connected with your channel name, plus Test, Reconnect, and Remove buttons. Send a test message to make sure it lands.

Choose what posts to Slack

In the notification matrix, enable the Slack channel for the event types your team wants in-channel (many teams start with the Critical tier plus free-tier and trial warnings). Slack toggles in the matrix are admin-only; members keep their personal email, push, and digest choices.

What lands in the channel#

Conceptually, every message is built the same way: which event fired, and a link back into the dashboard where the detail lives. Slack gets the headline; the dashboard has the story: the run, the numbers, the report. Expect a prompt to click through, not a wall of data in-channel.

Because of that, channel choice matters more than formatting. Pick a channel the team actually watches: alerts posted into a busy general channel scroll away, while a dedicated alerts channel keeps CI signal visible. Slack follows the same per-type matrix and per-type cooldowns as every other channel, so a noisy pipeline will not flood the channel with duplicates.

Troubleshooting#

SymptomWhat to do
The test message does not arriveConfirm the card shows Connected with the channel you expect, then send another test. If it still fails, use Reconnect to redo the authorization.
Messages stopped arrivingUse Reconnect and choose a current channel during the Slack authorization; this refreshes the connection end to end.
A specific event type never postsSlack is enabled per event type: check that the Slack channel is on for that type in the notification matrix.
You cannot see the Slack cardSlack settings are owner- and admin-only; members do not manage the integration.
You want Latchkey out of Slack entirelyRemove disconnects the integration; notification history in the dashboard is unaffected.

For the full list of event types and tiers you can route to Slack, see Notifications.