# ntfy

> 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.

App · 7 actions. Web page: https://docs.lodol.com/docs/integrations/ntfy

## Actions

### 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 (`topic`, text, required): 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_id`, text, required): Which notification: the notification_id that Send a notification returned for it, or that Get recent messages found.

**Outputs**

- `deleted` (true/false): True: the notification was deleted, or cancelled.
- `event_id` (text): The ID ntfy gave this change.
- `notification_id` (text): The notification that was changed.
- `time_iso` (text): When the change was made (UTC).
- `topic` (text): The notification's topic.
- `web_url` (text): 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**

```json
{
  "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 (`topic`, text, required): 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_id`, text, required): Which notification: the notification_id that Send a notification returned for it, or that Get recent messages found.

**Outputs**

- `dismissed` (true/false): True: the notification was marked read and dismissed.
- `event_id` (text): The ID ntfy gave this change.
- `notification_id` (text): The notification that was changed.
- `time_iso` (text): When the change was made (UTC).
- `topic` (text): The notification's topic.
- `web_url` (text): 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**

```json
{
  "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 (`topic`, text, required): The topic to read, as you subscribed to it in the ntfy app. Letters, numbers, - and _ only, up to 64; capitals count.
- Since (`since`, text): 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_time`, date 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_id`, text): 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 (`priorities`, list): Only get messages with one of these priorities. Leave empty for all. One or more of: `urgent`, `high`, `default` (Normal), `low`, `min`.
- Only tagged (`tags`, text): Only get messages that have all of these tags, separated by commas, such as backup, failed.
- Include scheduled (`include_scheduled`, true/false): Also get notifications that are waiting to be sent later. Default: `false`.
- Number of messages (`limit`, number): 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**

- `count` (number): How many messages are in messages.
- `has_more` (true/false): True when more matched than Number of messages allowed: raise it, or narrow Since.
- `latest_message_id` (text): The newest message ID read. Pass it to After message ID next time to get only what is new.
- `messages` (list): The messages, newest first, up to Number of messages.
- `older_messages_dropped` (true/false): True when the server left the oldest messages out because there were too many to send at once.
- `topic` (text): The topic that was read.
- `total_count` (number): How many messages matched, before Number of messages.
- `web_url` (text): 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**

```json
{
  "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 (`topic`, text, required): The topic to read, as you subscribed to it in the ntfy app. Letters, numbers, - and _ only, up to 64; capitals count.

**Outputs**

- `found` (true/false): False when the topic holds no messages right now.
- `message` (object): The newest message, or null when there is none.
- `topic` (text): The topic that was read.
- `web_url` (text): 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**

```json
{
  "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 (`topic`, text, required): 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 (`file`, text, required): 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_name`, text): The name the file is shown with, extension included, such as report.pdf. Leave blank to keep its own name.
- Message (`message`, text): Text to send with the file. Leave blank and ntfy says “You received a file” with the file's name.
- Title (`title`, text): A title shown in bold above the message. Leave blank to show the topic's name.
- Priority (`priority`, text): 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 (`emoji`, list): 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 (`tags`, text): 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_url`, text): 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.

- `attachment` (object): The file attached to the message, if there is one.
- `buttons` (list): The buttons on the notification (up to 3).
- `click_url` (text): What opens when the notification is tapped.
- `expires_iso` (text): When the server forgets it (UTC): 12 hours after it was sent on ntfy.sh. Phones that got it keep it.
- `icon_url` (text): The picture shown beside it, if one was set.
- `id` (text): This message's own ID, e.g. 7xQ1ZtgAbC2d.
- `is_update` (true/false): True when it replaced an earlier version of the notification.
- `markdown` (true/false): True when the text is formatted with Markdown.
- `message` (text): The text of the notification.
- `notification_id` (text): 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.
- `priority` (number): How urgent it is, from 1 (min) to 5 (urgent); 3 is normal.
- `priority_name` (text): The priority's name: urgent, high, default, low or min.
- `scheduled` (true/false): True while it is waiting to go out at a later time.
- `tags` (list): Its tags. Ones that are emoji codes (such as warning) show as emoji in the notification.
- `time` (number): When it was sent, or will go out if scheduled, in Unix seconds.
- `time_iso` (text): When it was sent, or will go out if scheduled, as an ISO 8601 time in UTC, e.g. 2026-10-19T22:43:04Z.
- `title` (text): The title, if it has one.
- `topic` (text): The topic it was sent to.
- `web_url` (text): 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**

```json
{
  "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 (`topic`, text, required): 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 (`message`, text, required): The text of the notification, up to about 4,000 characters.
- Title (`title`, text): A title shown in bold above the message. Leave blank to show the topic's name.
- Priority (`priority`, text): 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 (`emoji`, list): 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 (`tags`, text): 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 (`markdown`, true/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_url`, text): A link to open when the notification is tapped: a web page, or a mailto:, tel: or geo: link.
- Icon (`icon_url`, text): A link to a JPEG or PNG picture to show beside the notification. Android shows it; other apps may not.
- Buttons (`buttons`, list): 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_at`, date 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.

- `attachment` (object): The file attached to the message, if there is one.
- `buttons` (list): The buttons on the notification (up to 3).
- `click_url` (text): What opens when the notification is tapped.
- `expires_iso` (text): When the server forgets it (UTC): 12 hours after it was sent on ntfy.sh. Phones that got it keep it.
- `icon_url` (text): The picture shown beside it, if one was set.
- `id` (text): This message's own ID, e.g. 7xQ1ZtgAbC2d.
- `is_update` (true/false): True when it replaced an earlier version of the notification.
- `markdown` (true/false): True when the text is formatted with Markdown.
- `message` (text): The text of the notification.
- `notification_id` (text): 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.
- `priority` (number): How urgent it is, from 1 (min) to 5 (urgent); 3 is normal.
- `priority_name` (text): The priority's name: urgent, high, default, low or min.
- `scheduled` (true/false): True while it is waiting to go out at a later time.
- `tags` (list): Its tags. Ones that are emoji codes (such as warning) show as emoji in the notification.
- `time` (number): When it was sent, or will go out if scheduled, in Unix seconds.
- `time_iso` (text): When it was sent, or will go out if scheduled, as an ISO 8601 time in UTC, e.g. 2026-10-19T22:43:04Z.
- `title` (text): The title, if it has one.
- `topic` (text): The topic it was sent to.
- `web_url` (text): 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**

```json
{
  "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 (`topic`, text, required): 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_id`, text, required): Which notification: the notification_id that Send a notification returned for it, or that Get recent messages found.
- Message (`message`, text, required): The text of the notification, up to about 4,000 characters.
- Title (`title`, text): A title shown in bold above the message. Leave blank to show the topic's name.
- Priority (`priority`, text): 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 (`emoji`, list): 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 (`tags`, text): 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 (`markdown`, true/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_url`, text): A link to open when the notification is tapped: a web page, or a mailto:, tel: or geo: link.
- Icon (`icon_url`, text): A link to a JPEG or PNG picture to show beside the notification. Android shows it; other apps may not.
- Buttons (`buttons`, list): 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_at`, date 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.

- `attachment` (object): The file attached to the message, if there is one.
- `buttons` (list): The buttons on the notification (up to 3).
- `click_url` (text): What opens when the notification is tapped.
- `expires_iso` (text): When the server forgets it (UTC): 12 hours after it was sent on ntfy.sh. Phones that got it keep it.
- `icon_url` (text): The picture shown beside it, if one was set.
- `id` (text): This message's own ID, e.g. 7xQ1ZtgAbC2d.
- `is_update` (true/false): True when it replaced an earlier version of the notification.
- `markdown` (true/false): True when the text is formatted with Markdown.
- `message` (text): The text of the notification.
- `notification_id` (text): 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.
- `priority` (number): How urgent it is, from 1 (min) to 5 (urgent); 3 is normal.
- `priority_name` (text): The priority's name: urgent, high, default, low or min.
- `scheduled` (true/false): True while it is waiting to go out at a later time.
- `tags` (list): Its tags. Ones that are emoji codes (such as warning) show as emoji in the notification.
- `time` (number): When it was sent, or will go out if scheduled, in Unix seconds.
- `time_iso` (text): When it was sent, or will go out if scheduled, as an ISO 8601 time in UTC, e.g. 2026-10-19T22:43:04Z.
- `title` (text): The title, if it has one.
- `topic` (text): The topic it was sent to.
- `web_url` (text): 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**

```json
{
  "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"
}
```
