Ntfy

ntfy

Send push notifications to your phone or desktop via PUT/POST

Notifications Developer Tools Web del proveedor

Acciones

Triggers

Autenticación

—

OAuth gestionado

Información técnica: el detalle de parámetros, schemas y triggers de esta página está pensado para equipos de integración. Si solo necesitas saber si tu herramienta favorita está disponible, basta con ver la lista de acciones.

Acciones disponibles (22)

Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.

Create NTFY AccountNTFY_CREATE_ACCOUNTAcción

Tool to register a new user account on ntfy. Use when you need to create a new user account on the ntfy.sh hosted service. Note: This endpoint is not available on self-hosted instances unless signup is explicitly enabled in the server configuration.

Parámetros de entrada

passwordstringObligatorio
The password for the new account. Should be strong and secure.
usernamestringObligatorio
The desired username for the new account. Must be unique and meet format requirements (typically alphanumeric with certain special characters allowed).

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create Web Push SubscriptionNTFY_CREATE_WEBPUSH_SUBSCRIPTIONAcción

Tool to register a web push subscription for browser notifications. Use when you need to enable push notifications from ntfy topics through a browser's native push notification system.

Parámetros de entrada

authstringObligatorio
The authentication secret from the browser's push subscription, used to authenticate messages. Base64-encoded auth secret.
p256dhstringObligatorio
The P-256 elliptic curve Diffie-Hellman public key from the browser's push subscription, used for message encryption. Base64-encoded public key.
topicsstring[]
List of ntfy topic names to subscribe to. Maximum of 50 topics allowed. If user authentication is enabled, the user must have read access to all specified topics.
endpointstringObligatorio
The push service endpoint URL from the browser's push subscription. Must be from an approved domain (*.google.com, *.googleapis.com, Mozilla, Microsoft, Apple push services).

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete Web Push SubscriptionNTFY_DELETE_WEBPUSH_SUBSCRIPTIONAcción

Tool to unregister a web push subscription from the ntfy server. Use when you need to remove browser push notifications for a previously registered endpoint.

Parámetros de entrada

endpointstringObligatorio
The web push subscription endpoint URL to delete. This is the browser-provided push endpoint (e.g., from fcm.googleapis.com, Mozilla, Microsoft, or Apple push services) that was previously registered.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Fetch Cached MessagesNTFY_FETCH_CACHED_MESSAGESAcción

Tool to fetch cached messages from a ntfy topic. Use when you need to retrieve previously sent messages stored on the server. Supports filtering by time (duration or timestamp), message ID, content, title, priority, and tags. Set poll=1 to return immediately after fetching available cached messages.

Parámetros de entrada

idstring
Only return messages matching this exact message ID.
pollinteger
Set to 1 to return cached messages and immediately close connection after reading available messages. Without this, the connection stays open for streaming.
tagsstring
Filter by tags. Requires all listed tags to match. Comma-separated.
sincestring
Filter messages since a specific point. Accepts duration (e.g., '10m', '30s', '2h'), Unix timestamp (e.g., '1635528757'), message ID (e.g., 'nFS3knfcQ1xe'), or 'all' to return all cached messages.
titlestring
Filter by exact title string.
topicstringObligatorio
The topic name to fetch messages from.
messagestring
Filter by message content.
prioritystring
Filter by priority level. Accepts comma-separated values 1-5, where 1 is lowest and 5 is highest priority.
scheduledinteger
Set to 1 to include scheduled/delayed messages in the results.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Fetch Latest Message from TopicNTFY_FETCH_LATEST_MESSAGEAcción

Tool to fetch the most recent message from a topic's cache. Use when you need to retrieve the latest message without subscribing to the topic stream.

Parámetros de entrada

topicstringObligatorio
The topic name to fetch the most recent message from.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Fetch Scheduled MessagesNTFY_FETCH_SCHEDULED_MESSAGESAcción

Tool to fetch messages scheduled for later delivery from a topic. Use when you need to retrieve messages that are set to be delivered at a future date. The poll=1 and scheduled=1 parameters are automatically set to retrieve cached scheduled messages in a single request.

Parámetros de entrada

authstring
Base64-encoded authentication query parameter as alternative to Authorization header for protected topics.
topicstringObligatorio
Topic name to fetch scheduled messages from.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Account InformationNTFY_GET_ACCOUNTAcción

Tool to retrieve account data for authenticated user or anonymous user. Use when you need to get account information, limits, statistics, or tier details.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Server StatisticsNTFY_GET_STATSAcción

Tool to retrieve server statistics including message counts and publishing rates. Use when you need to monitor ntfy server activity and get metrics about message volume.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Service TiersNTFY_GET_TIERSAcción

Tool to list all available ntfy service tiers with their limits and features. Use when you need to retrieve subscription tier information including pricing and usage limits. Requires that payments are enabled on the server.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get File Attachment MetadataNTFY_HEAD_FILEAcción

Tool to get file attachment metadata from a message without downloading the file content. Use when you need to check file size, content type, or verify file existence in the ntfy attachment cache.

Parámetros de entrada

message_idstringObligatorio
The unique identifier for the message/file attachment. Must be 1-64 characters consisting of alphanumeric characters, hyphens, or underscores. An optional file extension may be appended (e.g., .txt, .jpg).

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Check NTFY Service HealthNTFY_HEALTH_CHECKAcción

Tool to check the health status of the ntfy service. Use when you need to verify if the ntfy service is operational and responding correctly.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Poll Messages from TopicNTFY_POLL_MESSAGESAcción

Tool to poll for messages from an ntfy topic without maintaining a long-standing connection. Use when you need to retrieve cached messages and have the connection close immediately after delivery. The connection ends after reading all available messages matching the criteria.

Parámetros de entrada

idstring
Filter to return only messages matching this exact message ID.
tagsstring
Filter by message tags (comma-separated).
sincestring
Fetch messages since a point in time. Accepts duration (e.g., '10m', '12h'), Unix timestamp, message ID, or 'all' for all cached messages. Defaults to 'all' if omitted.
titlestring
Filter to return only messages matching this exact title.
topicstringObligatorio
Target topic name to poll messages from. Supports comma-separated list for multiple topics.
messagestring
Filter to return only messages matching this exact message string.
prioritystring
Filter by message priority level (1-5, where 1=min, 3=default, 5=max).
scheduledstring
Include scheduled/delayed messages in results. Set to '1' to include.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Publish Message as JSON to NTFYNTFY_PUBLISH_JSONAcción

Tool to publish messages as JSON to ntfy. Use when you need to send notifications with all parameters in the request body, especially useful for integrations that cannot add custom headers.

Parámetros de entrada

callstring
Phone number for voice call notifications or 'yes' to use default
iconstring
Icon URL for notification display
tagsstring[]
List of tags/emojis for the notification
clickstring
Website URL opened when notification is clicked
delaystring
Delivery delay (e.g., '30min', '9am', '2h')
emailstring
E-mail recipient address for email notifications
titlestring
Notification title. If not provided, defaults to 'ntfy.sh/<topic>'
topicstringObligatorio
Target topic name to publish the message to (e.g., 'mytopic')
attachstring
Attachment URL
actionsobject[]
Custom action buttons for the notification. Each action should have 'action', 'label', and 'url' fields.
messagestring
Message body text. Defaults to 'triggered' if omitted.
filenamestring
Attachment filename
markdownboolean
Set to true if message uses Markdown formatting
priorityinteger
Priority level: 1=min, 2=low, 3=default, 4=high, 5=max

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Publish Message to TopicNTFY_PUBLISH_MESSAGEAcción

Tool to publish a message to a ntfy topic. Use when you need to send notifications or alerts to a topic. Topics are created dynamically if they don't exist.

Parámetros de entrada

iconstring
URL to a custom icon image to display with the notification.
tagsstring
Comma-separated list of emoji shortcodes or text tags to display with the notification.
clickstring
URL to open when the notification is clicked.
delaystring
Schedule the notification for delayed delivery (e.g., '30m', '1h', 'tomorrow 10am'). Minimum delay is 10 seconds, maximum is 3 days.
emailstring
Email address to forward the notification to.
titlestring
Optional notification title. If not provided, topic name is used.
topicstringObligatorio
The topic name to publish the message to. Topic will be created dynamically if it doesn't exist.
attachstring
URL of a file to attach to the notification.
actionsstring
Action button definitions (maximum 3 buttons per message). Format: 'action, label, url; ...'
messagestringObligatorio
The message body text to publish.
filenamestring
Custom filename for the attachment (only used if attach is specified).
markdownboolean
Enable Markdown formatting in the message body. Default is False.
priorityintegerenum
Priority level (1=min, 2=low, 3=default, 4=high, 5=max/urgent). Default is 3.
12345

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Publish Message to Topic (PUT)NTFY_PUBLISH_MESSAGE_PUTAcción

Tool to publish a message to a topic using PUT method. Use when you need to send notifications to subscribers of a topic. Supports various options like priority, tags, attachments, and scheduled delivery.

Parámetros de entrada

iconstring
URL of a custom icon to display with the notification.
tagsstring
Comma-separated emoji tags or custom labels for categorizing the message.
clickstring
URL to open when the notification is clicked.
delaystring
Scheduled delivery time using duration (e.g., '30min', '1h'), Unix timestamp, or natural language.
emailstring
Email address to forward the notification to.
titlestring
Notification title displayed prominently in the notification.
topicstringObligatorio
Target topic name to publish the message to.
attachstring
URL of a file to attach to the notification.
actionsstring
JSON string array of user action buttons (up to 3) for interactive notifications.
messagestringObligatorio
The notification message content to be published.
filenamestring
Custom filename for the attachment. Only used when attach is provided.
markdownboolean
Enable Markdown formatting in the message body.
priorityinteger
Message priority level (1=min, 3=default, 5=max). Controls notification urgency.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Publish Message via GETNTFY_PUBLISH_VIA_GETAcción

Tool to publish messages to ntfy via GET request with URL parameters. Use when PUT/POST methods are unavailable or for simple webhook integration. Supports all message parameters as query strings. Without parameters, sends 'triggered' as message.

Parámetros de entrada

authstring
Authentication credentials as query parameter.
callstring
Trigger phone call notification (phone number or 'yes').
iconstring
Notification icon URL.
tagsstring
Comma-separated list of emoji/tag identifiers.
cachestring
Control message caching behavior.
clickstring
Target URL opened when notification is clicked.
delaystring
Schedule delivery using duration or timestamp (e.g., '30m', '1h', 'tomorrow 10am').
emailstring
Forward notification to specified email address.
titlestring
Notification title that overrides the topic name.
topicstringObligatorio
The topic name to publish the message to. This will be part of the URL path.
attachstring
Attachment file URL.
actionsstring
Custom action button definitions (string format for GET requests).
messagestring
Custom message body text. If not provided, defaults to 'triggered'.
filenamestring
Custom attachment filename (only used if attach is specified).
firebasestring
Control Firebase push notification behavior.
markdownboolean
Enable Markdown formatting in message body.
priorityinteger
Urgency level from 1-5 (1=min, 3=default, 5=max). Default is 3 if not specified.
templatestring
Template name for JSON transformation (e.g., 'github', 'grafana', 'alertmanager').

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Send Message via WebhookNTFY_SEND_WEBHOOKAcción

Tool to send messages via webhook endpoint using simple GET request. Use when you need a simple webhook-style integration or for clients with limited HTTP support.

Parámetros de entrada

callstring
Phone number for voice call notification or 'yes' to use default
iconstring
Custom notification icon URL
tagsstring
Comma-separated tags/emojis for the message
clickstring
Website/URL to open when notification is clicked
delaystring
Scheduled delivery time (duration or natural language). Can also use 'at' or 'in' parameters.
emailstring
Email address to forward message via email
titlestring
Message title. Overrides default topic URL.
topicstringObligatorio
Target topic name to send the message to
attachstring
URL of file attachment
messagestring
Custom message body. Defaults to 'triggered' if omitted.
filenamestring
Custom filename for attachment
markdownboolean
Enable Markdown formatting for the message
prioritystring
Message priority. Accepts 1-5 or 'min'/'low'/'default'/'high'/'max'/'urgent'.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Subscribe to NTFY Topic with FiltersNTFY_SUBSCRIBE_FILTEREDAcción

Tool to subscribe to a ntfy topic with filters based on message fields (id, message, title, priority, tags). Use when you need to retrieve specific messages from a topic using filter criteria. Returns matching messages from the topic as a JSON stream.

Parámetros de entrada

idstring
Filter by exact message ID
pollstring
Set to '1' to enable polling mode - returns cached messages and closes connection instead of keeping stream open
tagsstring
Filter by tags (comma-separated). All specified tags must match (AND logic)
sincestring
Return cached messages since duration (e.g., '10m'), Unix timestamp, or message ID
titlestring
Filter by exact title text
topicstringObligatorio
The topic name to subscribe to
messagestring
Filter by exact message text
prioritystring
Filter by priority level (comma-separated for multiple). Values: 1-5 or min/low/default/high/max/urgent. Uses OR logic for multiple values
scheduledstring
Include scheduled/delayed messages in results. Set to '1' to include

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Subscribe to Topic (JSON Stream)NTFY_SUBSCRIBE_JSON_STREAMAcción

Tool to subscribe to a ntfy topic and receive messages as JSON stream. Use when you need to retrieve cached messages from a topic. The action polls the topic and returns immediately with cached messages.

Parámetros de entrada

idstring
Filter by exact message ID.
pollboolean
If true, return cached messages and close connection immediately. If false, maintain long-standing connection (not recommended for actions). Default is true.
tagsstring
Comma-separated tags list (logical AND).
sincestring
Filter messages by time/ID. Accepts duration (e.g., '10m', '1h'), Unix timestamp, message ID, or 'all' for all cached messages.
titlestring
Filter by exact title.
topicstringObligatorio
Topic name to subscribe to. Supports comma-separated list for multiple topics.
messagestring
Filter by exact message text.
prioritystring
Comma-separated priority list (logical OR). Values: min, low, default, high, urgent, or 1-5.
scheduledboolean
Include scheduled/delayed messages in response.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Subscribe to Multiple NTFY TopicsNTFY_SUBSCRIBE_MULTIPLE_TOPICSAcción

Tool to subscribe to multiple ntfy topics simultaneously using comma-separated topic list. Use when you need to receive messages from multiple topics in a single API call. Returns cached messages when used with poll=true parameter.

Parámetros de entrada

idstring
Filter by exact message ID.
authstring
Authentication credentials (encoded). Can also use HTTP Basic Auth headers.
pollboolean
If true, return cached messages and close connection immediately. Works with 'since' parameter (defaults to since=all if not specified).
tagsstring
Filter by tags (comma-separated, AND logic). Only returns messages matching all listed tags.
sincestring
Return cached messages since specified time/ID. Accepts formats: duration (e.g., '10m', '30s'), Unix timestamp (e.g., '1635528757'), message ID (e.g., 'nFS3knfcQ1xe'), 'all' (entire cache), or 'latest' (most recent only).
titlestring
Filter by exact title text.
topicsstring[]Obligatorio
List of topic names to subscribe to. Topic names are case-sensitive and can contain letters, numbers, underscores, and hyphens.
messagestring
Filter by exact message text.
prioritystring
Filter by priority levels (comma-separated, OR logic). Values: 1-5 (1=min, 3=default, 5=max).
scheduledboolean
If true, include scheduled/delayed messages in the message list.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Subscribe to Topic (Raw Stream)NTFY_SUBSCRIBE_RAW_STREAMAcción

Tool to subscribe to a topic and receive message bodies as raw text stream. Use when you need to retrieve messages without metadata like priority, tags, or titles. Each line in the response contains only the message body. Empty lines represent keepalive messages. In streaming mode, the connection remains open to receive new messages. With poll=1, cached messages are returned and the connection closes.

Parámetros de entrada

idstring
Filter returning only exact message ID matches.
pollboolean
Return cached messages and close connection. If true (poll=1), returns all cached messages and closes connection. If false or not set, streams messages in real-time.
tagsstring
Filter by comma-separated tags. Returns messages matching all listed tags.
sincestring
Return cached messages since timestamp, duration or message ID. Examples: '10m', '1645970742', 'nFS3knfcQ1xe', 'all', 'latest'.
titlestring
Filter for exact title string matches.
topicstringObligatorio
The topic name to subscribe to.
messagestring
Filter for exact message body matches.
prioritystring
Filter by comma-separated priorities. Returns messages matching any listed priority.
scheduledboolean
Include scheduled/delayed messages in message list. Set to true to include scheduled messages.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Trigger NTFY WebhookNTFY_TRIGGER_WEBHOOKAcción

Tool to trigger a webhook to publish a message to an ntfy topic via simple HTTP GET request. Use when you need to send notifications through webhooks without requiring a POST body. Sends a default 'triggered' message if no custom message is provided.

Parámetros de entrada

tagsstring
Comma-separated list of tags that may map to emojis.
clickstring
Website URL opened when notification is clicked.
titlestring
Message title. If not provided, defaults to 'ntfy.sh/<topic>'.
topicstringObligatorio
The topic name to publish the message to. This will be part of the URL path.
messagestring
Custom message text to publish. If not provided, defaults to 'triggered'.
priorityinteger
Message priority level (1=min, 3=default, 5=max).

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not