Setting Up Slack Incoming Webhooks

CerteroX SaaS Integration Guide

March 2026

Overview

This guide walks you through setting up Incoming Webhooks for a Slack app in the Certero Limited workspace. Incoming Webhooks allow external services to post messages directly into Slack channels using simple HTTP POST requests with a JSON payload.

Once configured, you can use the generated Webhook URL to send automated notifications from CerteroX SaaS or other integrated services into your chosen Slack channels.

Prerequisites

·        Admin or authorized access to the Certero Limited Slack workspace

·        Permission to create Slack apps in your workspace

·        Access to the Slack API portal (api.slack.com)

Part 1: Create a New Slack App

The first step is to create a new Slack application that will host your Incoming Webhook integration.

Step 1: Navigate to Your Apps

Go to the Slack API portal and navigate to "Your Apps". You will see any existing apps listed (e.g., CerteroX Notifications). Click the green "Create New App" button in the top-right corner.

Step 2: Choose "From scratch"

In the "Create an app" dialog, select "From scratch" to manually configure your app's basic info, scopes, settings, and features. This gives you full control over the app configuration.

Step 3: Name Your App

Enter a clear and memorable app name. In this example, we use "CerteroX SaaS Slack". Note that app names do not allow certain special characters and only a limited number of characters are permitted.

Step 4: Select the Workspace

Click the "Pick a workspace to develop your app in" dropdown and select "Certero Limited". Important: You cannot change this app's workspace later. If you leave the workspace, you will not be able to manage any apps you have built for it.

Step 5: Create the App

With the app name entered and workspace selected, click the "Create App" button to finalize the app creation. You will be taken to the app's Basic Information page.

Part 2: Configure Incoming Webhooks

With the app created, you now need to enable and configure Incoming Webhooks.

Step 6: Navigate to Incoming Webhooks

On the app's Basic Information page, you will see the App Credentials section showing your App ID, Client ID, Client Secret, Signing Secret, and Verification Token. In the left sidebar under "Features", click on "Incoming Webhooks" to navigate to the webhook configuration page.

Step 7: Activate Incoming Webhooks

On the Incoming Webhooks page, you will see the "Activate Incoming Webhooks" toggle which is set to "Off" by default. Click the toggle to turn it on. Incoming webhooks are a simple way to post messages from external sources into Slack using normal HTTP requests with a JSON payload.

Step 8: Add a New Webhook to Your Workspace

After activating webhooks, scroll down to the "Webhook URLs for Your Workspace" section. This area shows a sample curl request for posting to a channel and a table listing your webhook URLs. Click the "Add New Webhook to Workspace" button to generate your first webhook URL.

Step 9: Select a Channel

You will be prompted to select a Slack channel where the webhook will post messages. Choose the appropriate channel for your CerteroX SaaS notifications. You can create multiple webhooks for different channels if needed.

Step 10: Copy Your Webhook URL

Once the webhook is created, your unique Webhook URL will appear in the table. Click "Copy" to copy the URL. This URL is what you will use in external services and scripts to send messages to the selected Slack channel. Keep this URL secure as anyone with the URL can post messages to your channel.

Part 3: CerteroX SaaS Configuration

Step 1: Start by opening the settings to manage your integrations.

Step 2: Navigate to the Integration Channels tab to customize how your platform connects to other services.

Step 3: Click Add Channel to begin setting up a new notification channel for your workspace.

Step 4: Enter a clear Display Name to keep your notification channel organized.

Step 5: Click Add Channel to confirm and create your Slack notification channel.

Step 6: Paste your unique Slack Webhook URL so notifications reach the right workspace.

Step 7: Double-check the Webhook URL for accuracy, ensuring instant and reliable Slack updates.

Step 8: Finalize your Slack channel integration by clicking Add Channel and boost real-time communication.

Step 9: Use the Copy action to quickly share or reuse your Slack integration link.

Step 10: Verification of email sent

Part 4: Testing Your Webhook

Once you have your Webhook URL, you can test it using the sample curl command provided on the Incoming Webhooks page.

Sample Test Command

curl -X POST -H "Content-type: application/json" --data '{"text":"Hello, World!"}' YOUR_WEBHOOK_URL_HERE

Replace YOUR_WEBHOOK_URL_HERE with the actual webhook URL you copied in Step 10. If successful, you should see "Hello, World!" appear in your selected Slack channel.

Key Information

Webhook URL Security: Treat your Webhook URL as a secret. Do not share it publicly or commit it to public code repositories. Anyone with the URL can post messages to your Slack channel.

Multiple Webhooks: You can create multiple webhook URLs, each targeting a different Slack channel. This is useful for routing different types of notifications to separate channels.

Message Formatting: Incoming Webhooks support rich message formatting using Slack's Block Kit and message attachments. Send your message as JSON in the body of an application/json POST request.

Bot User: Adding incoming webhooks requires a bot user. If your app does not already have one, Slack will automatically add one for you.

Deactivation: If you deactivate incoming webhooks, new Webhook URLs will not be generated when your app is installed. To remove access to existing Webhook URLs, you will need to revoke all OAuth tokens.

Troubleshooting

Webhook not posting messages: Verify the webhook URL is correct and the toggle is set to "On". Check that the channel still exists and the app has not been removed from the workspace.

Permission denied errors: Ensure you have admin or authorized access to create apps in the Certero Limited workspace. Contact your Slack workspace administrator if needed.

Cannot change workspace: The workspace selection is permanent for each app. If you need to use a different workspace, create a new app in that workspace.