Post to a channel with an incoming webhook
Send messages into a channel from CI, scripts, alerts, Zapier, Make, n8n, Slack-style tools, or GitHub.
Written By Katja Danilina
Last updated 24 days ago
An incoming webhook is a secret URL for one channel. Anything that can send an HTTP request can post there: a CI job, a deploy script, a cron job, an alert, or an automation tool such as Zapier, Make, or n8n.
Posts show the webhook's own name and icon with an APP badge, never the name of the person who created it.
Create a webhook
In the channel, open the ··· menu and choose Integrations.
Select Add source, then Incoming webhook.
Give it a name, such as Deploys, and pick or upload an icon.
Select Create webhook, then Copy URL, and store it right away, for example as a secret in your CI.
Mantle shows the full URL only once. If you lose it, open the webhook and select Rotate URL to get a new one. You can add a webhook if you created the channel or you're a workspace admin or owner.
Send a message
Send a POST request with a JSON body that has a text field:
curl -X POST -H 'content-type: application/json' -d '{"text":"Deploy 1042 finished"}' $MANTLE_WEBHOOK_URL
The message appears in the channel right away. Messages support Mantle's markdown and can be grouped into a thread.
Tools that already post to Slack or GitHub
Slack-style webhooks: many monitoring, uptime, and CI tools can post to a Slack webhook. Use Copy Slack URL and paste it into the tool's Slack webhook field.
GitHub: in your repository or organization, go to Settings → Webhooks → Add webhook, paste the URL from Copy GitHub URL, and choose application/json. Pushes, pull requests, reviews, issues, comments, releases, and workflow runs are posted to the channel.
Keep the URL secret
Anyone with the URL can post to the channel. Store it as a secret, never in code or a public place. If it leaks, select Rotate URL.
Full reference, recipes, limits, and errors: https://docs.mantle.chat/integrations/incoming-webhooks
Was this helpful?
More in Integrations
Connect an app (integrations overview)Integration access and safetyStill need help? Ask the team