Listeners and History
A listener is a channel for messages from one tool, project, or automation.
Create separate listeners such as Deployments, Payments, and AI agent to
keep their events organized.
Names, tokens, and send URLs
Tap Create new in the app, then give the listener a name. Open its menu to rename it, copy its ID or send URL, change settings, or view History. Names can be up to 120 characters long. Renaming a listener keeps its token and send URL unchanged.
https://push.palmpush.com/send/<listener-token>The listener ID and token are the same value. Anyone with the token can send messages, subscribe another device, and change shared listener settings. Treat the token and send URL like secrets. If a token is exposed, create a new listener and update your integrations to use its URL.
Use a listener on another device
On the second device, tap Add by token, paste the listener ID, and tap Subscribe listener. New messages can then reach both subscribed devices.
The listener name and its overall enabled setting are shared. Each device has its own mute setting, avatar, and History. Subscribing another device does not copy the first device's past History.
No account or sign-in is required. Keep the listener token somewhere you can retrieve it if you replace your device. Losing an installation also loses its local device identity; subscribing again does not restore that installation's History or avatar.
Notification permission and delivery settings
iOS notification permission controls whether alerts can appear on this device. Listener management and History work without it. Use Manage in the app to request permission or open iOS Settings after a denial.
The listener menu has two separate switches:
- listener enabled controls the whole listener. When off, sends are skipped for every subscribed device and no new History events are written.
- enabled for this device controls this subscription. When off, this device
receives no push alerts for the listener, but new events appear in its History
as
Muted. Other devices are unaffected.
Disabling iOS notification permission is separate from muting a listener.
An event may be marked Sent while iOS permission is off, because Sent records
provider acceptance, not the display of an alert.
Set a listener avatar
In the listener menu, tap Set a Listener avatar. Choose a photo or use Take Photo, adjust the square crop using the round preview, and save it. Use Change Avatar to replace it or Remove to clear it.
The avatar helps identify this listener in notifications. It is set separately
for each device: the same listener can show a different photo on another iPhone.
There is no avatarUrl field to add to a send request. The message's own title
and body are preserved.
Only the cropped photo is uploaded and stored. Replacing or removing it, or removing this device's subscription, deletes the previous stored avatar, with retry cleanup if necessary. Other devices' avatars are unaffected. Uninstalling the app is not the same as removing a subscription inside the app.
Avatars are separate from per-message image attachments. You can use both in one notification.
Read History
Open the listener menu and tap History. Use Refresh to reload the current page and Previous or Next to browse older events.
History stores the title, body, optional image URL, optional tap URL, and delivery result for this device. Line breaks are preserved. Images appear above the text; tap an image for a full-screen view and zoom.
Sent: a push provider accepted the request. Device receipt is not confirmed.Failed: the delivery attempt failed.Muted: this device's listener switch was off when the message was sent.Pending: the delivery result has not yet been recorded.
In version 1.1, tapping a newly sent notification without a url opens and
highlights its matching History entry, including entries on older pages. An
unavailable entry falls back to recent events. See Links and tap actions.
Remove a listener
Deleting a listener in the app removes this device's subscription and its stored avatar. Other devices stay subscribed. If no subscribed devices remain, the backend deletes the listener and its send URL stops working.
Current scope
palmpush supports text, image attachments, optional tap links, and per-device listener avatars. It does not provide scheduled sends or user accounts. Push delivery depends on the network, device settings, and push providers; do not use it for emergencies or situations where a missed alert could cause harm.