Do I need an ntfy account?

Not on ntfy.sh for a public topic — you pick a name and subscribe. For a protected topic you need a user with write access, and you pass its credentials to FishOut as ?auth= on the topic URL. On your own server, it is whatever you have configured.

Why do some alerts buzz harder than others?

FishOut sets priority 4 when the post’s Reply call is Reply now — fresh, and asking for what you do — and 3 for everything else. That is the one difference between a push you should act on now and one that can wait.

Will a burst flood my phone?

No. ntfy channels batch by default: the first mention pushes at once and the rest of a five-minute window arrive as one push listing the top five. You can set the window to 1, 15, 30 or 60 minutes.

Can I self-host ntfy and still use FishOut?

Yes, as long as your server is reachable over public HTTPS: FishOut checks at send time that the hostname resolves to public addresses, and publishes JSON to your server’s root with the topic in the body.

IntegrationsPush notifications

Mentions as a push to your phone, via ntfy

ntfy turns a URL into a phone notification, with no account needed on ntfy.sh and nothing at all if you host it yourself. It is the lightest way to have the posts worth answering find you, and the one destination where FishOut sets the priority for you.

Start free Read the alerts docs

Every alert channel is on every plan, including Free. ntfy.sh’s free tier allows 250 messages a day.

[01] WHAT LANDS THERE/ A TOPIC

A mention, as it arrives in ntfy

Rendered by the code that sends it, from a sample Reddit post. Never the post body.

ntfyntfy.sh/acme-mentions-7f3k9qnow

Reply now: a relevant post on Reddit

Shared inbox for two people without a full helpdesk? Relevance 96 · Topic · Neutral · by quietledger Hint: Answer the question directly Labels: Asking for recommendations, Has a problem

Open in FishOutView on Reddit

Priority 4 · high · tag fish

[02] CONNECT IT/ SETUP

Point FishOut at a topic

3 steps, a few minutes end to end.

1
Pick a topic nobody will guess
On ntfy.sh, topic names are public: anyone who guesses yours can read it. Use a long random name, or a protected topic on your own server. Subscribe to it in the ntfy app on your phone.
topic url
```
https://ntfy.sh/acme-mentions-7f3k9q
```
2
For a protected topic, add ?auth=
ntfy accepts credentials as an auth query parameter (base64, no padding). It is the only query parameter FishOut allows on an ntfy URL, and FishOut keeps it when it publishes to your server’s root.
protected topic
```
https://ntfy.acmemail.com/mentions?auth=QmFzaWMgZEdWemREcHdZWE56
```
3
Paste it into FishOut and set a high floor
Under Settings → Notifications, add an ntfy channel. A push is the most expensive interruption you have: 90 is a good start, and batching (on by default) turns a burst into one push.

Then set the floor

ntfy is for the posts you would get up for. A floor of 90 means a Reply now post — someone asking for exactly what you sell, still fresh — arrives at high priority with a long vibration, and almost nothing else arrives at all. Keep everything between 70 and 90 in a chat channel where it can wait for morning.

Settings · Notifications

ntfy

https://ntfy.sh/…

Healthy

Relevance floor90

Eventsmention.scored

Batch bursts5 min

[03] WHAT IS IN IT/ FIELDS

What ntfy receives, field by field

Built from the event’s envelope and nothing else, so a retry renders exactly the message the first attempt would have.

Field		How
Title	Clipped	The headline, clipped at 120 characters, prefixed 🐟 by the fish tag.
Message	Shown	Post title, then the facts line, the hint and the labels, as plain text.
Priority	Shown	4 (high) when the Reply call is Reply now; 3 (default) otherwise.
Tap and actions	Shown	Tapping opens the mention in FishOut; two view actions: Open in FishOut, View on Reddit.
Post body	Never	Never sent: the envelope does not carry it.

[04] TEN PINGS OR ONE/ DIGEST

A burst arrives as one message

ntfy batches by default. Here 3 posts were held after the first; they arrive together when the window closes, best first.

ntfyntfy.sh/acme-mentions-7f3k9qnow

3 new mentions for AcmeMail

• Shared inbox for a dental practice, what works? (Reddit · 95) • Leaving Notchmail this month, need a replacement (Reddit · 91) • Best tool for two people answering one support address (Reddit · 88)

Open in FishOut

Priority 3 · default · tag fish

[05] WHAT WILL BITE YOU/ LIMITS

ntfy’s limits, not ours

These are ntfy’s constraints, checked against the ntfy documentation and pricing. Failures are tracked per channel, so one broken destination never stops the others.

Priority runs from 1 (min) to 5 (max/urgent). At 4, high, Android gives a long vibration burst and a pop-over notification — which is what a Reply now post gets. [source]

A notification can carry up to three actions. FishOut uses two: Open in FishOut and View on the platform. [source]

Topic names on ntfy.sh are public, so a guessable name is a readable feed of your mentions. Pick something long and random, or use access control. [source]

ntfy.sh’s free tier allows 250 messages a day, with a request bucket of 60 refilled one every five seconds. Paid tiers start at 2,500 a day; self-hosting has whatever limits you set. [source]

A message over 4,096 bytes is turned into an attachment. A FishOut push is a few hundred bytes. [source]

In the channel’s delivery history
You see	It means	Do this
ntfy_unauthorized	The topic is protected and the auth value is missing or wrong.	Regenerate the auth parameter for a user with write access.
ntfy_message_too_large	The server refused the size (413).	Check a self-hosted server’s message limit.
http_429	ntfy.sh’s request or daily limit was reached. Retried.	Raise the floor, or use a paid ntfy.sh tier or your own server.