Skip to main content
The Hookie Slack app posts each event a Slack destination sends as a card: a title and severity taken from the payload, its fields, and a View in Hookie button. It ships with Hookie as a Slack app manifest, so you create it in a few clicks and own it in your Slack workspace. The app asks for one permission, incoming-webhook. It can post to the channel you install it to, and it can read nothing.

Add to Slack

The quickest way in. If your project’s Connections tab shows Add to Slack above the destinations, Hookie’s own Slack app connects a channel in one step, with no app to create and no URL to copy.
1

Choose Add to Slack

In the console, open your project’s Connections tab and choose Add to Slack. You need a role that can add destinations.
2

Pick the channel

Slack asks you to allow Hookie to post to a channel in your Slack workspace. Pick the channel and choose Allow.
3

Back in Hookie, it is ready

You return to Connections with a new Slack destination named after the channel, such as Slack #alerts (Acme). It delivers every dataset until you give it a Dataset filter.
Hookie keeps only the channel’s webhook URL, encrypted and shown masked, and discards the access token Slack also sends. To connect another channel, choose Add to Slack again. The new destination counts toward your plan’s destination limit. If you cancel on Slack’s screen, or the connection is started in one browser and finished in another, nothing is created and Connections says why. Choose Add to Slack again.

Install your own copy of the app

Use this when Add to Slack is not shown, or when you want the app to belong to your Slack workspace.
1

Start a Slack destination

In the console, open your project’s Connections tab. Choose Add destination, then Slack under Type.
2

Create the app from its manifest

Choose Create the Hookie Slack app. Slack opens Create app from manifest with the Hookie app filled in. Pick your Slack workspace, review it, and choose Create.
3

Give it the Hookie icon

Download the Hookie app icon. In the app’s settings, open Basic Information, and upload it under Display Information. Every card posts under the app’s name and icon, so this is what your team sees beside each alert.
4

Install it to a channel

Choose Install to Workspace, pick the channel the cards go to, and choose Allow.
5

Copy the channel's URL into Hookie

Under Incoming Webhooks, copy the URL. It starts https://hooks.slack.com/services/. Paste it into Slack incoming-webhook URL, name the destination, and choose Create.
Anyone who holds the URL can post to the channel, so treat it like a password. Hookie stores it encrypted and only ever shows a masked hint. See Slack destinations.
If the link does not open, go to api.slack.com/apps, choose Create New App, then From a manifest, and paste the manifest below.
The manifest sets the app’s name, description and background colour. Slack does not let a manifest carry an icon, which is why you upload it yourself.

Send cards to more than one channel

One incoming webhook posts to one channel. With Add to Slack, choose it again and pick the next channel. With your own copy of the app, open the app’s Incoming Webhooks page, choose Add New Webhook to Workspace, and pick the channel. Then create a second Slack destination with the new URL. Give each destination a Dataset filter so each channel gets only the datasets it wants. For example, send alerts to #on-call and orders to #sales.

What a card shows

The notification text is the severity, the title and the dataset, such as [CRITICAL] CPU above 90% on web-1 · alerts. Everything from the payload is shown as text. A value such as <!channel> does not notify anyone. For example, this payload:
becomes a card with a red bar, the title CPU above 90% on web-1, a CRITICAL badge, and the fields host, labels.region and labels.team. Every value fits on the card, so there is no JSON block.

Severity

Matching ignores case and surrounding spaces. Any other value, such as "status": "paid", is shown as an ordinary field and the card has the Hookie blue bar.

Write your own message

To post something other than the card, choose JSON template under Body on the destination. A template replaces the card, so it must be a Slack message body:
See Body for placeholders.