Support

Pulse is developer-friendly push notifications. Send a notification to your iPhone from any script with curl. A topic you create becomes a channel. Messages stay in the feed, and, once you allow notifications, they can also arrive as a system alert.

Getting started

Create an account with email and password, or use Sign in with Apple on iPhone when that server offers it. If the server requires verification, enter the code from the email. “Email me a code” on the sign-in screen is another way in.
Create a channel. Open New Subscription and enter a topic name, such as backups. Pulse creates that topic for your account and subscribes this device. A publish secret is stored as a hash on the server and saved in the keychain on the phone.
Open the integration snippet for that channel and copy the curl example. Copy includes the publish secret in an X-Pulse-Token header. The snippet on screen stays masked until you tap Show secret.

The copied command has this shape. YOUR_TOPIC_SECRET stands in for the secret the app copied. It is not a working token.

curl \
  -H "X-Pulse-Token: YOUR_TOPIC_SECRET" \
  -d "Backup finished" \
  https://api.pulsenotifications.app/backups

Run it against the same server the app is signed in to. The hosted app uses https://api.pulsenotifications.app. The new message shows in the feed. After you tap Enable notifications and allow them, the same publish can also arrive as a system notification. The system prompt appears only after that tap.

FAQ

I’m not receiving notifications

In Settings, tap Enable notifications and allow the system prompt. If the system will not ask again, that row opens Settings.
The phone needs to be subscribed to the topic you published.
A muted channel is saved, and the server skips it when sending a push. Unmute the channel if you want the alert.
Quiet hours suppress the banner and the sound. The message still arrives in the feed. See below.
The command has to use the current X-Pulse-Token and the server the app is signed in to. A wrong or replaced secret is rejected, and the message is not stored.

Quiet hours

Quiet hours are stored on this device. They are not part of the account, and they stay after you sign out. The control is in Settings. It is off until you turn it on. The starting window is 22:00 to 07:00, and you can change both times. Times follow this device.

While quiet hours are on, Pulse does not play an alert sound or show a banner, including for a muted channel. Notifications still arrive in the feed.

Rotating a secret

The publish secret is the X-Pulse-Token value. The server stores a hash. Replacing the secret makes the previous value stop working, including any script that still sends it.

Open the channel’s integration snippet. If this device does not already have a secret stored and your account owns the channel, tap Generate new secret and confirm Replace the publish secret. Then copy the new curl snippet. If the device already has the secret, the same screen shows the current snippet. Copy sends the real header. Show secret reveals it on screen.

Deleting your account

In the app, open Settings, then Account, then Delete Account, and confirm. Pulse deletes the account on the server you are signed in to and returns you to sign-in. That removes the account, its sessions, its email codes, its push tokens and subscriptions, and the topics it owns, including the messages on those topics. A topic the account does not own stays, including the hosted announcements topic.

On the phone, the session and that account’s cached channels and notifications are cleared. Quiet hours and the saved server stay. The full list is in the Privacy Policy.

Forget this server, in Settings, only removes that server from the device. It does not delete the account.

Using a server you run

A self-hosted server is optional. In Settings, open Server and save an https:// address, or an http:// address on your local network. Saving a different server signs you out. The next sign-in uses an account on that server. The hosted session does not carry over, and a publish has to go to the server the app is using.

That server has its own accounts and its own database. The Privacy Policy describes the Pulse app and the hosted service. Whoever runs the other server handles the data stored there.

Contact

Email support@pulsenotifications.app.