How do I create a Slack webhook?

Step-by-step guide to creating a Slack incoming webhook for use with Yeethook.

To receive notifications in Slack, you need an incoming webhook URL. This guide walks you through creating one.

Prerequisites

  • A Slack workspace where you have permission to add apps
  • A channel where you want to receive notifications

Step-by-step

1. Create a Slack app

The fastest way is to use Yeethook's pre-configured manifest. During the Connect Slack step, click the Create Slack App button. This opens the Slack app creation page with the name, settings, and incoming webhooks already configured.

Alternatively, go to api.slack.com/apps, click Create New App, choose From a manifest, and paste the manifest provided in the setup wizard.

Select your workspace and click Create.

Optionally, you can set a custom app icon by going to Settings > Basic Information > Display Information after creating the app.

The Yeethook Slack app only requests the incoming-webhook scope, which is write-only access to a single channel. For more details, see Is the Slack bot safe to install?.

2. Add a webhook to your workspace

In the sidebar, click Incoming Webhooks. Since the manifest pre-enables this feature, the toggle should already be on.

Click Add New Webhook to Workspace at the bottom of the page.

Select the channel where you want Yeethook to post notifications (e.g. #app-events).

Click Allow to authorize the webhook.

3. Copy the webhook URL

After authorization, you will see a new webhook URL in the list. It looks like:

https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX

Click Copy to copy the URL.

Add to Yeethook

Back in Yeethook, on the Connect Slack step:

  1. Paste the webhook URL you copied
  2. Optionally add a label (e.g. "#app-events") so you can identify it later
  3. Click Connect Slack

Yeethook will verify the webhook and start delivering notifications to your Slack channel.

Troubleshooting

  • "Invalid webhook URL" error -- make sure the URL starts with https://hooks.slack.com/services/. Other URLs are not accepted.
  • Not receiving notifications -- check that the Slack app is still installed in your workspace and that the webhook is active. Go to api.slack.com/apps, select your app, and check Incoming Webhooks.
  • Want to change the channel? -- add a new webhook for the new channel in Slack, then update the webhook URL in Yeethook.