DocsIntegrationsntfy

ntfy

Push notifications through ntfy, a free app for Android, iOS and the desktop. Use the public ntfy.sh server or run your own.

CategoryPush
Used byntfy node
Secret fields2
TestYes

Set it up

  1. Install the ntfy app and subscribe to a topic. Pick a long, hard-to-guess name: on ntfy.sh anyone who knows a topic can read it.
  2. Add an ntfy integration with the same topic, and an access token if your server needs one.
  3. Press Test. A notification should arrive on your phone.
  4. Pick it in an ntfy node.

Fields

FieldRequiredWhat it is
ServerserverUrlNohttps://ntfy.sh by default, or your own server's address.
TopictopicsecretYes1–64 letters, digits, - or _. Kept secret, since knowing it is enough to read it.
Access tokenaccessTokensecretNoFor a protected topic.

Secret fields are encrypted as soon as you save them and never shown again: the console shows their last four characters so you can tell which one is saved. Replace one to rotate it; workflows pick up the new one on their next step.

Test it

Sends a test notification to the topic. ntfy has no way to check access without publishing.

Problems you might see

CodeMeans
INTEGRATION_SECRET_INVALIDThe topic is missing or has characters ntfy doesn't allow.
INTEGRATION_AUTH_FAILEDThe server refused the access token.

Codes starting INTEGRATION_ come from saving or testing. Every other integration code is on the error codes page.