n8n-nodes-ntfy-client | Tomasz Wyderka

About

n8n-nodes-ntfy-client is a community node for n8n that integrates ntfy.sh — a simple HTTP-based pub-sub notification service. It supports both sending notifications and subscribing to topics, with authentication handled in line with n8n conventions.

Works with the public ntfy.sh server and self-hosted instances alike.

Nodes

ntfy.sh Send

Publishes a notification to an ntfy.sh topic. Runs once per workflow execution.

Parameter	Required	Description
Topic	Yes	Topic name to publish to (e.g. `my-alerts`)
Message	Yes	Notification body text
Title	No	Notification title
Priority	No	`Min (1)` / `Low (2)` / `Default (3)` / `High (4)` / `Urgent (5)`
Tags	No	Comma-separated tags or emoji (e.g. `warning,📦`)

ntfy.sh Trigger

Subscribes to one or more ntfy.sh topics using a persistent JSON stream. Triggers the workflow for each incoming message.

Parameter	Required	Description
Topics	Yes	Topic name(s). Use commas for multiple: `alerts,backup,system`
Since	No	`New messages only` (default) / `Last 10 minutes` / `Last 1 hour` / `All cached`

Output — the full ntfy.sh message object:

{
  "id": "abc123",
  "time": 1716000000,
  "topic": "alerts",
  "event": "message",
  "message": "Server is down",
  "title": "Alert",
  "priority": 5,
  "tags": ["warning"]
}

On connection loss the trigger reconnects automatically with exponential backoff (up to 5 retries). Authentication errors (401/403) surface immediately without retrying.

Authentication (ntfy.sh API)

After installing, create a new credential of type ntfy.sh API:

Field	Description
Server URL	`https://ntfy.sh` for the public server, or your self-hosted address
Authentication Type	`None` / `Basic Auth` / `Access Token`
Username / Password	Shown when `Basic Auth` is selected
Access Token	Shown when `Access Token` is selected

The credential is tested automatically against GET /v1/health when saved.

Installation

In your n8n instance go to Settings → Community Nodes → Install and enter:

n8n-nodes-ntfy-client

Requirements

n8n >=1.0.0
ntfy.sh server (self-hosted or public ntfy.sh)

License

MIT