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
| Action | What it does |
|---|---|
| Delete a notification | Delete a notification from every phone and desktop that got it, and from the ntfy app. |
| 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. |
| 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. |
| 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. |
| 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. |
| Send a notification | Send a push notification to every phone, desktop and browser subscribed to a topic in the ntfy app. |
| Update a notification | Replace 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
- Topic
topictextRequired - 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 ID
notification_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
- Topic
topictextRequired - 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 ID
notification_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
- Topic
topictextRequired - The topic to read, as you subscribed to it in the ntfy app. Letters, numbers, - and _ only, up to 64; capitals count.
- Since
sincetext - 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 since
since_timedate and time - Get the messages sent at or after this time.Only when Since is Since a date and time.
- After message ID
after_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 priorities
prioritieslist - Only get messages with one of these priorities. Leave empty for all.One or more of:
urgent,high,default(Normal),low,min. - Only tagged
tagstext - Only get messages that have all of these tags, separated by commas, such as backup, failed.
- Include scheduled
include_scheduledtrue/false - Also get notifications that are waiting to be sent later.Default:
false. - Number of messages
limitnumber - 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
- Topic
topictextRequired - 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
- Topic
topictextRequired - 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.
- File
filetextRequired - 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 name
file_nametext - The name the file is shown with, extension included, such as report.pdf. Leave blank to keep its own name.
- Message
messagetext - Text to send with the file. Leave blank and ntfy says “You received a file” with the file's name.
- Title
titletext - A title shown in bold above the message. Leave blank to show the topic's name.
- Priority
prioritytext - 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. - Emoji
emojilist - 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. - Tags
tagstext - 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 tapped
click_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
- Topic
topictextRequired - 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.
- Message
messagetextRequired - The text of the notification, up to about 4,000 characters.
- Title
titletext - A title shown in bold above the message. Leave blank to show the topic's name.
- Priority
prioritytext - 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. - Emoji
emojilist - 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. - Tags
tagstext - 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 Markdown
markdowntrue/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 tapped
click_urltext - A link to open when the notification is tapped: a web page, or a mailto:, tel: or geo: link.
- Icon
icon_urltext - A link to a JPEG or PNG picture to show beside the notification. Android shows it; other apps may not.
- Buttons
buttonslist - 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 at
send_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
- Topic
topictextRequired - 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 ID
notification_idtextRequired - Which notification: the notification_id that Send a notification returned for it, or that Get recent messages found.
- Message
messagetextRequired - The text of the notification, up to about 4,000 characters.
- Title
titletext - A title shown in bold above the message. Leave blank to show the topic's name.
- Priority
prioritytext - 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. - Emoji
emojilist - 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. - Tags
tagstext - 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 Markdown
markdowntrue/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 tapped
click_urltext - A link to open when the notification is tapped: a web page, or a mailto:, tel: or geo: link.
- Icon
icon_urltext - A link to a JPEG or PNG picture to show beside the notification. Android shows it; other apps may not.
- Buttons
buttonslist - 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 at
send_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"
}