Skip to content

How to create a Slack webhook

Create an Incoming Webhook URL in Slack and connect it to CivicNexus list notifications.

What is a Slack webhook?

A Slack Incoming Webhook is a private URL that lets another tool (like CivicNexus) post messages into a specific Slack channel.

Step 1: Create (or choose) a Slack app

  1. Go to Slack’s app dashboard: https://api.slack.com/apps
  2. Create a new app (or select an existing one).
  3. Choose the workspace where you want notifications delivered.

Tip: It can help to create a dedicated channel like #civicnexus-alerts so notifications stay organized.

Step 2: Enable Incoming Webhooks

  1. In your Slack app settings, open Incoming Webhooks.
  2. Turn on Activate Incoming Webhooks.

Step 3: Create the webhook URL (choose a channel)

  1. Click Add New Webhook to Workspace.
  2. Choose the channel where you want CivicNexus notifications to post.
  3. Click Authorize.

Note: If you want to post to a private channel, you need to join that channel before authorizing.

Step 4: Copy the webhook URL

After authorization, you’ll see a webhook URL in your app settings. It will look like:

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

Keep this URL secure.

Connect the webhook to CivicNexus

  1. In the CivicNexus app, open notification settings for a list.
  2. Expand Advanced options.
  3. Paste the webhook into Slack webhook URL.
  4. Save your notification settings.

Keep it secure

Your webhook URL is a secret. Treat it like a password:

  • Don’t share it publicly or commit it to version control.
  • If you think it was exposed, create a new webhook URL and update CivicNexus.

Troubleshooting

  • I can’t add a webhook to my workspace: your Slack workspace may restrict app installs. Ask a Slack admin for help.
  • I can’t choose the channel I want: for private channels, you must join the channel before authorizing.
  • Messages aren’t showing up: confirm the webhook URL starts with https://hooks.slack.com/, and confirm notifications are enabled for at least one list.

Reference

Slack’s official guide:

← Back to resources