ntfy

App · 7 actions

Send push notifications to your phone, desktop or browser with ntfy, no account needed: subscribe to a topic in the ntfy app and send to it from a workflow, with a title, priority, emoji, buttons, files or a time to send. Update or delete what you sent, read a topic's messages, and start a workflow when one arrives.

Actions

ActionWhat it does
Delete a notificationDelete a notification from every phone and desktop that got it, and from the ntfy app.
Dismiss a notificationMark a notification as read and take it off the notification list on every phone and desktop, once whatever it was about has been dealt with.
Get recent messagesGet the messages sent to a topic that ntfy still holds (the last 12 hours on ntfy.sh), newest first, from the last few minutes, since a time, or after a message.
Get the latest messageGet the newest message on a topic that ntfy still holds (the last 12 hours on ntfy.sh), such as the last status a device reported.
Send a fileSend a file, such as a photo, a PDF or a report, to everyone subscribed to a topic, with a message if you like.
Send a notificationSend a push notification to every phone, desktop and browser subscribed to a topic in the ntfy app.
Update a notificationReplace a notification sent earlier with new text, on every phone and desktop that got it: handy for progress updates.

Delete a notification

Delete a notification from every phone and desktop that got it, and from the ntfy app. If it is scheduled and hasn't gone out yet, it is cancelled and never sent.

Inputs

TopictopictextRequired
The topic to send to, as you subscribed to it in the ntfy app. Letters, numbers, - and _ only, up to 64; capitals count. Anyone who knows a topic's name can read it, so use one that's hard to guess.
Notification IDnotification_idtextRequired
Which notification: the notification_id that Send a notification returned for it, or that Get recent messages found.

Outputs

deletedtrue/false
True: the notification was deleted, or cancelled.
event_idtext
The ID ntfy gave this change.
notification_idtext
The notification that was changed.
time_isotext
When the change was made (UTC).
topictext
The notification's topic.
web_urltext
The topic's page in the ntfy web app, e.g. https://ntfy.sh/your-topic, where anyone with the link can read and subscribe to it.
Example output
{
  "deleted": true,
  "event_id": "HNsJSQg58bzC",
  "notification_id": "CKnkXG1h1D3N",
  "time_iso": "2026-10-19T22:50:54Z",
  "topic": "backups-7Hq2xP9",
  "web_url": "https://ntfy.sh/backups-7Hq2xP9"
}

Dismiss a notification

Mark a notification as read and take it off the notification list on every phone and desktop, once whatever it was about has been dealt with. It stays in the ntfy app's list for the topic.

Inputs

TopictopictextRequired
The topic to send to, as you subscribed to it in the ntfy app. Letters, numbers, - and _ only, up to 64; capitals count. Anyone who knows a topic's name can read it, so use one that's hard to guess.
Notification IDnotification_idtextRequired
Which notification: the notification_id that Send a notification returned for it, or that Get recent messages found.

Outputs

dismissedtrue/false
True: the notification was marked read and dismissed.
event_idtext
The ID ntfy gave this change.
notification_idtext
The notification that was changed.
time_isotext
When the change was made (UTC).
topictext
The notification's topic.
web_urltext
The topic's page in the ntfy web app, e.g. https://ntfy.sh/your-topic, where anyone with the link can read and subscribe to it.
Example output
{
  "dismissed": true,
  "event_id": "uwdqcIieQLyI",
  "notification_id": "AGgQWavgyjHA",
  "time_iso": "2026-10-19T22:50:54Z",
  "topic": "backups-7Hq2xP9",
  "web_url": "https://ntfy.sh/backups-7Hq2xP9"
}

Get recent messages

Get the messages sent to a topic that ntfy still holds (the last 12 hours on ntfy.sh), newest first, from the last few minutes, since a time, or after a message. Each notification comes once, as its latest version; deleted ones are left out. A message sent a second or two before may not show yet.

Inputs

TopictopictextRequired
The topic to read, as you subscribed to it in the ntfy app. Letters, numbers, - and _ only, up to 64; capitals count.
Sincesincetext
Which messages to get.One of: all (Everything ntfy still holds (12 hours on ntfy.sh)), 10m (The last 10 minutes), 1h (The last hour), 6h (The last 6 hours), time (Since a date and time), message (After a message). Default: all.
Sent sincesince_timedate and time
Get the messages sent at or after this time.Only when Since is Since a date and time.
After message IDafter_message_idtext
Get the messages sent after this one: an id or latest_message_id an earlier ntfy step returned.Only when Since is After a message.
Only these prioritiesprioritieslist
Only get messages with one of these priorities. Leave empty for all.One or more of: urgent, high, default (Normal), low, min.
Only taggedtagstext
Only get messages that have all of these tags, separated by commas, such as backup, failed.
Include scheduledinclude_scheduledtrue/false
Also get notifications that are waiting to be sent later.Default: false.
Number of messageslimitnumber
The most messages to get, newest first: from 1 to 100; 25 if left blank. total_count says how many there were.From 1 to 100. Default: 25.

Outputs

countnumber
How many messages are in messages.
has_moretrue/false
True when more matched than Number of messages allowed: raise it, or narrow Since.
latest_message_idtext
The newest message ID read. Pass it to After message ID next time to get only what is new.
messageslist
The messages, newest first, up to Number of messages.
older_messages_droppedtrue/false
True when the server left the oldest messages out because there were too many to send at once.
topictext
The topic that was read.
total_countnumber
How many messages matched, before Number of messages.
web_urltext
The topic's page in the ntfy web app, e.g. https://ntfy.sh/your-topic, where anyone with the link can read and subscribe to it.
Example output
{
  "count": 1,
  "has_more": false,
  "latest_message_id": "AGgQWavgyjHA",
  "messages": [
    {
      "attachment": null,
      "buttons": [
        {
          "action": "open",
          "body": null,
          "clear": false,
          "label": "Open report",
          "method": null,
          "url": "https://example.com/backups/latest",
          "value": null
        }
      ],
      "click_url": "https://example.com/backups",
      "dismissed": false,
      "expires_iso": "2026-10-20T10:43:04Z",
      "icon_url": null,
      "id": "AGgQWavgyjHA",
      "is_update": false,
      "markdown": false,
      "message": "The nightly backup of the shop database finished in 4 minutes.",
      "notification_id": "AGgQWavgyjHA",
      "priority": 4,
      "priority_name": "high",
      "scheduled": false,
      "tags": [
        "white_check_mark",
        "backup"
      ],
      "time": 1792449784,
      "time_iso": "2026-10-19T22:43:04Z",
      "title": "Backup finished",
      "topic": "backups-7Hq2xP9",
      "web_url": "https://ntfy.sh/backups-7Hq2xP9"
    }
  ],
  "older_messages_dropped": false,
  "topic": "backups-7Hq2xP9",
  "total_count": 1,
  "web_url": "https://ntfy.sh/backups-7Hq2xP9"
}

Get the latest message

Get the newest message on a topic that ntfy still holds (the last 12 hours on ntfy.sh), such as the last status a device reported. found is false when there is none. A message sent a second or two before may not show yet.

Inputs

TopictopictextRequired
The topic to read, as you subscribed to it in the ntfy app. Letters, numbers, - and _ only, up to 64; capitals count.

Outputs

foundtrue/false
False when the topic holds no messages right now.
messageobject
The newest message, or null when there is none.
topictext
The topic that was read.
web_urltext
The topic's page in the ntfy web app, e.g. https://ntfy.sh/your-topic, where anyone with the link can read and subscribe to it.
Example output
{
  "found": true,
  "message": {
    "attachment": null,
    "buttons": [
      {
        "action": "open",
        "body": null,
        "clear": false,
        "label": "Open report",
        "method": null,
        "url": "https://example.com/backups/latest",
        "value": null
      }
    ],
    "click_url": "https://example.com/backups",
    "dismissed": false,
    "expires_iso": "2026-10-20T10:43:04Z",
    "icon_url": null,
    "id": "AGgQWavgyjHA",
    "is_update": false,
    "markdown": false,
    "message": "The nightly backup of the shop database finished in 4 minutes.",
    "notification_id": "AGgQWavgyjHA",
    "priority": 4,
    "priority_name": "high",
    "scheduled": false,
    "tags": [
      "white_check_mark",
      "backup"
    ],
    "time": 1792449784,
    "time_iso": "2026-10-19T22:43:04Z",
    "title": "Backup finished",
    "topic": "backups-7Hq2xP9",
    "web_url": "https://ntfy.sh/backups-7Hq2xP9"
  },
  "topic": "backups-7Hq2xP9",
  "web_url": "https://ntfy.sh/backups-7Hq2xP9"
}

Send a file

Send a file, such as a photo, a PDF or a report, to everyone subscribed to a topic, with a message if you like. Upload one, pick one from an earlier step, or paste a link to one.

Inputs

TopictopictextRequired
The topic to send to, as you subscribed to it in the ntfy app. Letters, numbers, - and _ only, up to 64; capitals count. Anyone who knows a topic's name can read it, so use one that's hard to guess.
FilefiletextRequired
The file to send: upload one, pick one from an earlier step, or paste a link to one. ntfy.sh takes files up to 2 MB without a paid plan and deletes them after 3 hours; a linked file is downloaded from its link.
File namefile_nametext
The name the file is shown with, extension included, such as report.pdf. Leave blank to keep its own name.
Messagemessagetext
Text to send with the file. Leave blank and ntfy says “You received a file” with the file's name.
Titletitletext
A title shown in bold above the message. Leave blank to show the topic's name.
Priorityprioritytext
How strongly phones get your attention for it.One of: urgent (Urgent: long vibration bursts and a pop-up), high (High: a long vibration and a pop-up), default (Normal: the usual sound and vibration), low (Low: silent, shown when the notification list is opened), min (Min: silent, tucked under other notifications). Default: default.
Emojiemojilist
Emoji shown at the start of the title (or of the message, without a title), in the order picked.One or more of: white_check_mark (✅ Check mark), x (❌ Cross), warning (⚠️ Warning), rotating_light (🚨 Siren), no_entry (⛔ No entry), information_source (ℹ️ Information), bell (🔔 Bell), loudspeaker (📢 Loudspeaker), tada (🎉 Party popper), +1 (👍 Thumbs up), and 16 more.
Tagstagstext
Words shown under the notification, separated by commas, such as backup, server-1. A code from https://docs.ntfy.sh/emojis/ shows as its emoji instead.
Open when tappedclick_urltext
A link to open when the notification is tapped: a web page, or a mailto:, tel: or geo: link.

Outputs

The message carrying the file, as ntfy stored it.

attachmentobject
The file attached to the message, if there is one.
buttonslist
The buttons on the notification (up to 3).
click_urltext
What opens when the notification is tapped.
expires_isotext
When the server forgets it (UTC): 12 hours after it was sent on ntfy.sh. Phones that got it keep it.
icon_urltext
The picture shown beside it, if one was set.
idtext
This message's own ID, e.g. 7xQ1ZtgAbC2d.
is_updatetrue/false
True when it replaced an earlier version of the notification.
markdowntrue/false
True when the text is formatted with Markdown.
messagetext
The text of the notification.
notification_idtext
The notification this message belongs to. Update a notification, Dismiss a notification and Delete a notification take it. For a first message it is the same as id; an update keeps the original's.
prioritynumber
How urgent it is, from 1 (min) to 5 (urgent); 3 is normal.
priority_nametext
The priority's name: urgent, high, default, low or min.
scheduledtrue/false
True while it is waiting to go out at a later time.
tagslist
Its tags. Ones that are emoji codes (such as warning) show as emoji in the notification.
timenumber
When it was sent, or will go out if scheduled, in Unix seconds.
time_isotext
When it was sent, or will go out if scheduled, as an ISO 8601 time in UTC, e.g. 2026-10-19T22:43:04Z.
titletext
The title, if it has one.
topictext
The topic it was sent to.
web_urltext
The topic's page in the ntfy web app, e.g. https://ntfy.sh/your-topic, where anyone with the link can read and subscribe to it.
Example output
{
  "attachment": {
    "expires_iso": "2026-10-20T01:43:04Z",
    "name": "report.pdf",
    "size": 13264,
    "type": "application/pdf",
    "url": "https://ntfy.sh/file/QzwhExCbBy9W.pdf"
  },
  "buttons": [],
  "click_url": null,
  "expires_iso": "2026-10-20T10:43:04Z",
  "icon_url": null,
  "id": "QzwhExCbBy9W",
  "is_update": false,
  "markdown": false,
  "message": "Here is this week's sales report.",
  "notification_id": "QzwhExCbBy9W",
  "priority": 3,
  "priority_name": "default",
  "scheduled": false,
  "tags": [
    "memo"
  ],
  "time": 1792449784,
  "time_iso": "2026-10-19T22:43:04Z",
  "title": "Weekly report",
  "topic": "backups-7Hq2xP9",
  "web_url": "https://ntfy.sh/backups-7Hq2xP9"
}

Send a notification

Send a push notification to every phone, desktop and browser subscribed to a topic in the ntfy app. Give it a title, priority, emoji, a link to open when tapped and up to 3 buttons, or hold it to send at a later time. Returns its notification_id, for updating or deleting it later.

Inputs

TopictopictextRequired
The topic to send to, as you subscribed to it in the ntfy app. Letters, numbers, - and _ only, up to 64; capitals count. Anyone who knows a topic's name can read it, so use one that's hard to guess.
MessagemessagetextRequired
The text of the notification, up to about 4,000 characters.
Titletitletext
A title shown in bold above the message. Leave blank to show the topic's name.
Priorityprioritytext
How strongly phones get your attention for it.One of: urgent (Urgent: long vibration bursts and a pop-up), high (High: a long vibration and a pop-up), default (Normal: the usual sound and vibration), low (Low: silent, shown when the notification list is opened), min (Min: silent, tucked under other notifications). Default: default.
Emojiemojilist
Emoji shown at the start of the title (or of the message, without a title), in the order picked.One or more of: white_check_mark (✅ Check mark), x (❌ Cross), warning (⚠️ Warning), rotating_light (🚨 Siren), no_entry (⛔ No entry), information_source (ℹ️ Information), bell (🔔 Bell), loudspeaker (📢 Loudspeaker), tada (🎉 Party popper), +1 (👍 Thumbs up), and 16 more.
Tagstagstext
Words shown under the notification, separated by commas, such as backup, server-1. A code from https://docs.ntfy.sh/emojis/ shows as its emoji instead.
Format with Markdownmarkdowntrue/false
Show **bold**, *italics*, links and lists in the message. The ntfy web app shows the formatting; some phone apps show the text as written.Default: false.
Open when tappedclick_urltext
A link to open when the notification is tapped: a web page, or a mailto:, tel: or geo: link.
Iconicon_urltext
A link to a JPEG or PNG picture to show beside the notification. Android shows it; other apps may not.
Buttonsbuttonslist
Up to 3 buttons on the notification, each with a label. A button with a url opens it. Set action to request to send a request to the url instead (such as a webhook that starts another workflow), or give a value to copy it.
Send atsend_atdate and time
Hold the notification and send it at this time, up to 3 days ahead on ntfy.sh. Leave blank, or pick a time less than 10 seconds away, to send it now.

Outputs

The notification as ntfy stored it.

attachmentobject
The file attached to the message, if there is one.
buttonslist
The buttons on the notification (up to 3).
click_urltext
What opens when the notification is tapped.
expires_isotext
When the server forgets it (UTC): 12 hours after it was sent on ntfy.sh. Phones that got it keep it.
icon_urltext
The picture shown beside it, if one was set.
idtext
This message's own ID, e.g. 7xQ1ZtgAbC2d.
is_updatetrue/false
True when it replaced an earlier version of the notification.
markdowntrue/false
True when the text is formatted with Markdown.
messagetext
The text of the notification.
notification_idtext
The notification this message belongs to. Update a notification, Dismiss a notification and Delete a notification take it. For a first message it is the same as id; an update keeps the original's.
prioritynumber
How urgent it is, from 1 (min) to 5 (urgent); 3 is normal.
priority_nametext
The priority's name: urgent, high, default, low or min.
scheduledtrue/false
True while it is waiting to go out at a later time.
tagslist
Its tags. Ones that are emoji codes (such as warning) show as emoji in the notification.
timenumber
When it was sent, or will go out if scheduled, in Unix seconds.
time_isotext
When it was sent, or will go out if scheduled, as an ISO 8601 time in UTC, e.g. 2026-10-19T22:43:04Z.
titletext
The title, if it has one.
topictext
The topic it was sent to.
web_urltext
The topic's page in the ntfy web app, e.g. https://ntfy.sh/your-topic, where anyone with the link can read and subscribe to it.
Example output
{
  "attachment": null,
  "buttons": [
    {
      "action": "open",
      "body": null,
      "clear": false,
      "label": "Open report",
      "method": null,
      "url": "https://example.com/backups/latest",
      "value": null
    }
  ],
  "click_url": "https://example.com/backups",
  "expires_iso": "2026-10-20T10:43:04Z",
  "icon_url": null,
  "id": "AGgQWavgyjHA",
  "is_update": false,
  "markdown": false,
  "message": "The nightly backup of the shop database finished in 4 minutes.",
  "notification_id": "AGgQWavgyjHA",
  "priority": 4,
  "priority_name": "high",
  "scheduled": false,
  "tags": [
    "white_check_mark",
    "backup"
  ],
  "time": 1792449784,
  "time_iso": "2026-10-19T22:43:04Z",
  "title": "Backup finished",
  "topic": "backups-7Hq2xP9",
  "web_url": "https://ntfy.sh/backups-7Hq2xP9"
}

Update a notification

Replace a notification sent earlier with new text, on every phone and desktop that got it: handy for progress updates. The new version replaces the old one entirely, so include the title and anything else it should still show. A scheduled one that hasn't gone out is replaced, and goes out at the new Send at.

Inputs

TopictopictextRequired
The topic to send to, as you subscribed to it in the ntfy app. Letters, numbers, - and _ only, up to 64; capitals count. Anyone who knows a topic's name can read it, so use one that's hard to guess.
Notification IDnotification_idtextRequired
Which notification: the notification_id that Send a notification returned for it, or that Get recent messages found.
MessagemessagetextRequired
The text of the notification, up to about 4,000 characters.
Titletitletext
A title shown in bold above the message. Leave blank to show the topic's name.
Priorityprioritytext
How strongly phones get your attention for it.One of: urgent (Urgent: long vibration bursts and a pop-up), high (High: a long vibration and a pop-up), default (Normal: the usual sound and vibration), low (Low: silent, shown when the notification list is opened), min (Min: silent, tucked under other notifications). Default: default.
Emojiemojilist
Emoji shown at the start of the title (or of the message, without a title), in the order picked.One or more of: white_check_mark (✅ Check mark), x (❌ Cross), warning (⚠️ Warning), rotating_light (🚨 Siren), no_entry (⛔ No entry), information_source (ℹ️ Information), bell (🔔 Bell), loudspeaker (📢 Loudspeaker), tada (🎉 Party popper), +1 (👍 Thumbs up), and 16 more.
Tagstagstext
Words shown under the notification, separated by commas, such as backup, server-1. A code from https://docs.ntfy.sh/emojis/ shows as its emoji instead.
Format with Markdownmarkdowntrue/false
Show **bold**, *italics*, links and lists in the message. The ntfy web app shows the formatting; some phone apps show the text as written.Default: false.
Open when tappedclick_urltext
A link to open when the notification is tapped: a web page, or a mailto:, tel: or geo: link.
Iconicon_urltext
A link to a JPEG or PNG picture to show beside the notification. Android shows it; other apps may not.
Buttonsbuttonslist
Up to 3 buttons on the notification, each with a label. A button with a url opens it. Set action to request to send a request to the url instead (such as a webhook that starts another workflow), or give a value to copy it.
Send atsend_atdate and time
Hold the notification and send it at this time, up to 3 days ahead on ntfy.sh. Leave blank, or pick a time less than 10 seconds away, to send it now.

Outputs

The new version of the notification.

attachmentobject
The file attached to the message, if there is one.
buttonslist
The buttons on the notification (up to 3).
click_urltext
What opens when the notification is tapped.
expires_isotext
When the server forgets it (UTC): 12 hours after it was sent on ntfy.sh. Phones that got it keep it.
icon_urltext
The picture shown beside it, if one was set.
idtext
This message's own ID, e.g. 7xQ1ZtgAbC2d.
is_updatetrue/false
True when it replaced an earlier version of the notification.
markdowntrue/false
True when the text is formatted with Markdown.
messagetext
The text of the notification.
notification_idtext
The notification this message belongs to. Update a notification, Dismiss a notification and Delete a notification take it. For a first message it is the same as id; an update keeps the original's.
prioritynumber
How urgent it is, from 1 (min) to 5 (urgent); 3 is normal.
priority_nametext
The priority's name: urgent, high, default, low or min.
scheduledtrue/false
True while it is waiting to go out at a later time.
tagslist
Its tags. Ones that are emoji codes (such as warning) show as emoji in the notification.
timenumber
When it was sent, or will go out if scheduled, in Unix seconds.
time_isotext
When it was sent, or will go out if scheduled, as an ISO 8601 time in UTC, e.g. 2026-10-19T22:43:04Z.
titletext
The title, if it has one.
topictext
The topic it was sent to.
web_urltext
The topic's page in the ntfy web app, e.g. https://ntfy.sh/your-topic, where anyone with the link can read and subscribe to it.
Example output
{
  "attachment": null,
  "buttons": [
    {
      "action": "open",
      "body": null,
      "clear": false,
      "label": "Open report",
      "method": null,
      "url": "https://example.com/backups/latest",
      "value": null
    }
  ],
  "click_url": "https://example.com/backups",
  "expires_iso": "2026-10-20T10:43:04Z",
  "icon_url": null,
  "id": "HlOfZzKQmpR4",
  "is_update": true,
  "markdown": false,
  "message": "The nightly backup is 80% done.",
  "notification_id": "AGgQWavgyjHA",
  "priority": 4,
  "priority_name": "high",
  "scheduled": false,
  "tags": [
    "white_check_mark",
    "backup"
  ],
  "time": 1792449784,
  "time_iso": "2026-10-19T22:43:04Z",
  "title": "Backup finished",
  "topic": "backups-7Hq2xP9",
  "web_url": "https://ntfy.sh/backups-7Hq2xP9"
}

On this page