curl -H "Title: Task Complete" -d "Your message here" ntfy.sh/YOUR_TOPIC

With Priority

Priority levels: min, low, default, high, urgent

curl -H "Priority: high" -d "Your message here" ntfy.sh/YOUR_TOPIC

With Tags/Emojis

curl -H "Tags: white_check_mark" -d "Build succeeded" ntfy.sh/YOUR_TOPIC

Click Actions (Deeplinks)

Make the notification clickable - tapping it opens a URL or deeplink.

curl -H "Click: https://example.com" -d "Click to open" ntfy.sh/YOUR_TOPIC

Supports any URI scheme: https://, mailto:, app deeplinks, etc.

Action Buttons

Add up to 3 interactive buttons to notifications. Separate multiple actions with semicolons.

View Action (Open URL/App)

curl \
  -H "Actions: view, Open Link, https://example.com" \
  -d "Check this out" ntfy.sh/YOUR_TOPIC

HTTP Action (Trigger API)

curl \
  -H "Actions: http, Run Build, https://api.example.com/build, method=POST" \
  -d "Ready to deploy?" ntfy.sh/YOUR_TOPIC

Multiple Actions

curl \
  -H "Actions: view, View Logs, https://logs.example.com; http, Retry, https://api.example.com/retry, method=POST" \
  -d "Build failed" ntfy.sh/YOUR_TOPIC

Action Format

<type>, <label>, <url>, [options]

type: view or http
label: Button text
url: Target URL or deeplink
options: method=POST, body={"key":"value"}, clear=true

Combined Example

curl \
  -H "Title: Deploy Complete" \
  -H "Tags: rocket" \
  -H "Priority: high" \
  -H "Click: https://app.example.com" \
  -H "Actions: view, View Site, https://app.example.com; view, View Logs, https://logs.example.com" \
  -d "Production deployment finished successfully" \
  ntfy.sh/YOUR_TOPIC

When to Use

After completing a long-running task (builds, tests, deployments)
When an error occurs that needs attention
When user explicitly asks to be notified
When waiting for user input after completing work

Example Messages

Task completion: "Build completed successfully"
Error alert: "Build failed: 3 type errors found"
Status update: "Deployment to staging complete"

ntfy-notify

ntfy.sh Notifications

Configuration

How to Send Notifications

With a Title