−50%

50% off your first month on any paid plan · code WELCOME50 · until Nov 30

Start free →
Integration Team chat

How to send cron job and uptime alerts to Mattermost

· Setup · 1 minute

Post alerts to your self-hosted or cloud Mattermost. One incoming webhook per channel, no plugin needed.

What the alerts look like#

WatchCron posts a formatted message to the channel: monitor name, status, what triggered the alert, and a link to the incident page. Messages arrive within seconds of detection, whether your Mattermost runs on a $5 VPS or a corporate cluster.

Before you start#

You need:

  • A Mattermost instance (self-hosted or cloud) with incoming webhooks enabled by the system admin.
  • A WatchCron account on any plan. Mattermost alerts work on Free, Starter, Pro and Business.

One caveat: your Mattermost server must be reachable from the public internet. If it sits behind a VPN or firewall with no public endpoint, WatchCron can't deliver the POST request. Most cloud Mattermost instances are fine out of the box.

Step 1 — Create an incoming webhook#

Open the main menu, go to Integrations → Incoming Webhooks → Add Incoming Webhook.

Pick the channel where alerts should land, set the title to "WatchCron", and save. Mattermost shows you a URL that looks like https://chat.acme.io/hooks/xxxxxxxxxxxxxxxx. Copy it.

WhereWhat to do
Main menu → IntegrationsIncoming Webhooks → Add Incoming Webhook
After savingCopy the webhook URL

Step 2 — Add the channel in WatchCron#

Go to Alerts → Channels → Add channel and choose Mattermost.

FieldWhat to enter
LabelSomething recognisable, e.g. "~ops"
Webhook URLThe URL you copied from Mattermost

Click Save.

Step 3 — Test and assign monitors#

Click Send test. A message should appear in the Mattermost channel within a couple of seconds.

Open any monitor and tick the Mattermost channel under Alert channels. There's no cap on how many monitors point to one webhook.

What to paste where#

WatchCron fieldValueWhere you find it
Webhook URLhttps://chat.acme.io/hooks/xxxxxxxxxxxxxxxxIntegrations → Incoming Webhooks

What WatchCron sends#

Each message contains the monitor name, status (down, missed, or recovered), a short reason, and a direct link to the incident. Recovery messages use the same format, so your channel doubles as a lightweight incident log.

Mattermost renders the message as a bot post. If you want a custom avatar or display name, set those in the webhook configuration on the Mattermost side.

Troubleshooting#

A system admin needs to turn on incoming webhooks in System Console → Integrations → Integration Management. Once enabled, the menu item appears for everyone who has permission.

WatchCron sends an HTTP POST to the webhook URL. If the server isn't reachable from the public internet, the request won't arrive. Either open the port or set up a reverse proxy with a public endpoint.
Written by Vitalii Holben

Founder of WatchCron. Full-stack developer building monitoring tools that help teams keep cron jobs, uptime, and SSL certificates under control. Based in Europe, shipping code since 2014.

Start monitoring in under 2 minutes.

Free plan includes 20 checks · No credit card required
Pricing Docs
Log in Start free →