- Category: notifications
- Auth: API_KEY, BASIC
- Composio-managed OAuth available? N/A
- Tools: 12
- Triggers: 0
- Slug:
NTFY - Version: 20261101_00
Tools
Create NTFY Account
Create NTFY Account
Slug:
NTFY_CREATE_ACCOUNTTool 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.Input Parameters
The desired username for the new account. Must be unique and meet format requirements (typically alphanumeric with certain special characters allowed).
Output
Create Web Push Subscription
Create Web Push Subscription
Slug:
NTFY_CREATE_WEBPUSH_SUBSCRIPTIONTool 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.Input Parameters
The authentication secret from the browser’s push subscription, used to authenticate messages. Base64-encoded auth secret.
The P-256 elliptic curve Diffie-Hellman public key from the browser’s push subscription, used for message encryption. Base64-encoded public key.
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.
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).
Output
Delete Web Push Subscription
Delete Web Push Subscription
Slug:
NTFY_DELETE_WEBPUSH_SUBSCRIPTIONTool to unregister a web push subscription from the ntfy server. Use when you need to remove browser push notifications for a previously registered endpoint.Input Parameters
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.
Output
Fetch Scheduled Messages
Fetch Scheduled Messages
Slug:
NTFY_FETCH_SCHEDULED_MESSAGESTool 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.Input Parameters
Base64-encoded authentication query parameter as alternative to Authorization header for protected topics.
Output
Get Account Information
Get Account Information
Get Server Statistics
Get Server Statistics
Get Service Tiers
Get Service Tiers
Get File Attachment Metadata
Get File Attachment Metadata
Slug:
NTFY_HEAD_FILETool 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.Input Parameters
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).
Output
Check NTFY Service Health
Check NTFY Service Health
Publish Message to Topic
Publish Message to Topic
Slug:
NTFY_PUBLISH_MESSAGETool 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.Input Parameters
Schedule the notification for delayed delivery (e.g., ‘30m’, ‘1h’, ‘tomorrow 10am’). Minimum delay is 10 seconds, maximum is 3 days.
The topic name to publish the message to. Topic will be created dynamically if it doesn’t exist.
Priority level (1=min, 2=low, 3=default, 4=high, 5=max/urgent). Default is 3.
Output
Publish Message via GET
Publish Message via GET
Subscribe to Topic (Raw Stream)
Subscribe to Topic (Raw Stream)
Slug:
NTFY_SUBSCRIBE_RAW_STREAMRetrieve a topic’s message bodies as raw text, with optional filtering and polling. Polling requests cached messages and closes the connection; a non-polling request can remain open, so the tool may not return while the stream is open.Input Parameters
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.
Return cached messages since timestamp, duration or message ID. Examples: ‘10m’, ‘1645970742’, ‘nFS3knfcQ1xe’, ‘all’, ‘latest’.
Include scheduled/delayed messages in message list. Set to true to include scheduled messages.