Integrations

NotifyHero works with countless tools and services. Here are some popular integrations.

Monitoring Tools

Uptime Kuma

Uptime Kuma has built-in ntfy support.

  1. Go to Settings → Notifications
  2. Select "ntfy" as notification type
  3. Set server URL to https://app.notifyhero.com
  4. Set your topic name

Prometheus Alertmanager

Configure a webhook receiver:

receivers:
  - name: ntfy
    webhook_configs:
      - url: 'https://app.notifyhero.com/alerts'
        send_resolved: true

Grafana

Use Grafana's webhook contact point to send alerts:

  1. Go to Alerting → Contact points
  2. Add contact point with type "Webhook"
  3. Set URL to https://app.notifyhero.com/your-topic

Home Automation

Home Assistant

Add to configuration.yaml:

notify:
  - name: ntfy
    platform: rest
    resource: https://app.notifyhero.com/home
    method: POST
    headers:
      Priority: default

Then use in automations:

service: notify.ntfy
data:
  message: "Motion detected in living room"

Node-RED

Use an HTTP Request node:

  • Method: POST
  • URL: https://app.notifyhero.com/your-topic
  • Payload: Your message

CI/CD

GitHub Actions

See the Examples page for full workflow examples.

GitLab CI

notify:
  stage: .post
  script:
    - curl -d "Pipeline ${CI_PIPELINE_ID} completed" https://app.notifyhero.com/ci

Jenkins

Use the sh step or HTTP Request plugin to send notifications.

Backup Tools

Restic

restic backup /data && curl -d "Backup complete" https://app.notifyhero.com/backups

Duplicati

Configure a "run-script-after" that sends an ntfy notification.

Borg

borg create repo::archive /data && \
curl -d "Borg backup complete" https://app.notifyhero.com/backups

Development Tools

Apprise

Apprise supports ntfy:

import apprise

apobj = apprise.Apprise()
apobj.add('ntfy://app.notifyhero.com/mytopic')
apobj.notify(body='Hello!')

Shoutrrr

Shoutrrr supports ntfy:

shoutrrr send --url "ntfy://app.notifyhero.com/mytopic" --message "Hello!"

Chat & Communication

Slack (Incoming)

Forward Slack webhooks to ntfy using a simple proxy or Zapier.

Discord (Outgoing)

Use Discord webhooks to trigger ntfy notifications.

Database Tools

PostgreSQL

Trigger notifications from database events:

CREATE OR REPLACE FUNCTION notify_on_insert()
RETURNS trigger AS $$
BEGIN
  PERFORM pg_notify('new_record', NEW.id::text);
  -- Call external webhook
  RETURN NEW;
END;
$$ LANGUAGE plpgsql;

Email

Email to Push

Configure email forwarding to send notifications:

smtp-server-listen: ":25"
smtp-server-domain: "ntfy.example.com"

Then email mytopic@ntfy.example.com to send a push notification.

Custom Integrations

Webhooks

Any service that supports webhooks can integrate:

  1. Set webhook URL to https://app.notifyhero.com/your-topic
  2. Configure POST method
  3. Message goes in request body

REST APIs

Any language with HTTP support works:

// JavaScript
fetch('https://app.notifyhero.com/topic', {
  method: 'POST',
  body: 'Message'
});

# Python
import requests
requests.post('https://app.notifyhero.com/topic', data='Message')

// Go
http.Post("https://app.notifyhero.com/topic", "text/plain",
    strings.NewReader("Message"))

Community Integrations

The community has built many integrations:

  • ntfy-shellscripts - Shell script examples
  • Various Home Assistant integrations
  • Telegram bots that forward to ntfy
  • And many more on GitHub

Build Your Own

See the API documentation to build custom integrations.