NAiOS IconNAiOS Logo
Contacto
Volver al catálogo

Ntfy

ntfy

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

NotificationsDeveloper ToolsWeb del proveedor
Acciones
22
Triggers
0
Autenticación
—
OAuth gestionado
No
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