Integration Guides

How to Setup

1. In CronBeats dashboard: Go to Integrations → Email
2. Enter address: Type the email address where alerts should be sent
3. Choose alert rules: Enable DOWN alerts, RECOVERY alerts, or both
4. Save — alerts will send automatically, no test button needed

How to Setup

1. In Slack: Create an Incoming Webhook URL at api.slack.com/apps
2. In CronBeats: Go to Integrations → Slack and paste your webhook URL
3. Test it: Click "Send Test Message" to verify it works
4. Enable: Check the "Enable Slack notifications" checkbox

How to Setup

1. In Discord: Right-click your server → Server Settings → Integrations → Webhooks
2. Create Webhook: Click "New Webhook" and choose your target channel
3. Copy URL: Copy the webhook URL
4. In CronBeats: Go to Integrations → Discord and paste the webhook URL
5. Test it: Click "Send Test Message"

How to Setup

1. Create Bot: Talk to @BotFather on Telegram and create a new bot
2. Copy Token: Copy the bot token (e.g., 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11)
3. Get Your User ID (Easy Way):
   • Talk to @userinfobot on Telegram
   • It will immediately reply with your User ID
   • OR (harder): Send a message to your bot, then visit https://api.telegram.org/bot[YOUR_TOKEN]/getUpdates
4. In CronBeats: Paste both the Bot Token and Chat ID (your User ID)
5. Test it: Click "Send Test Message"

What It Does

Send a JSON POST request to any HTTP endpoint when jobs trigger alerts. Perfect for:

• Custom internal systems
• Logging platforms (Splunk, ELK, Datadog)
• Incident management (PagerDuty, Opsgenie)
• Automation workflows via Zapier/Make
• Ticketing systems (Jira, Linear, etc.)

Webhook Payload Examples

CronBeats sends a small integration.test payload for connection tests and a richer payload for real alert events.

Connectivity test payload

{
  "event": "integration.test",
  "source": "cronbeats",
  "channel": "webhook",
  "message": "Webhook integration test from CronBeats",
  "workspace_id": 123,
  "sent_at": "2026-02-24 12:06:54 UTC"
}

Production alert payload

{
  "schema_version": "1.1",
  "event": "job.down" | "job.recovery",
  "notification_type": "down" | "recovery",
  "job": {
    "id": 42,
    "name": "Database Backup",
    "schedule_value": "3600",
    "expected_interval_seconds": 3600
  },
  "workspace": {
    "id": 7,
    "name": "Production"
  },
  "timestamp": "2026-02-24T12:06:54+00:00",
  "message": "Job 'Database Backup' is DOWN",
  "dashboard_url": "https://cronbeats.com/jobs/42"
}

How to Setup

1. Prepare endpoint: Create an HTTP endpoint that accepts POST requests
2. Optional secret: Generate a secret for signature verification (HMAC-SHA256)
3. In CronBeats: Go to Integrations → Webhooks and enter your URL
4. Test connectivity: Click "Send Test Webhook" and verify the integration.test payload arrives
5. Verify production shape: Trigger a real DOWN/RECOVERY and confirm the production payload above
6. Verify signature: Check the X-CronBeats-Signature header for security

How To Use Secret Key

CronBeats never sends your raw secret to the endpoint. Instead it signs each request and sends only X-CronBeats-Signature.

1. Keep one shared secret in both CronBeats and your receiving service.
2. Read the raw body on your endpoint.
3. Compute HMAC-SHA256 using that raw body + secret.
4. Compare your result with the X-CronBeats-Signature header using a timing-safe compare.

If someone sends fake DOWN/RECOVERY webhooks to your URL, verification fails unless they know your secret. Test signature verification on both integration.test and production alert events.

With Zapier or Make as the action layer, CronBeats alerts can create tickets in Jira or Linear, trigger PagerDuty incidents, send SMS via Twilio, post to Google Chat, or run any automation across 8,000+ supported services — without writing any custom code.

How to Setup (Zapier)

1. Create Zap: Go to zapier.com and create a new Zap
2. Trigger: Choose "Webhooks by Zapier" as your trigger
3. Get Webhook URL: Zapier will give you a unique webhook URL
4. In CronBeats: Add that URL as a custom webhook in Integrations → Zapier
5. Choose Action: Set up your action (create ticket, send alert, etc.)
6. Test & Publish: Test your Zap and turn it on

How to Setup (Make)

1. Create Scenario: Go to make.com and create a new Scenario
2. Add Trigger: Click the plus icon and search for "Webhooks" module
3. Choose Trigger: Select "Custom webhook"
4. Get Webhook URL: Make will generate a unique webhook URL — copy this URL
5. In CronBeats: Paste the webhook URL in Integrations → Zapier
6. Add Action: Click the plus icon to add what happens next (send to Jira, Slack, etc.)
7. Map Fields: Connect CronBeats data to your action fields
8. Test & Activate: Test your scenario, then turn it on