Pulsetray

Pulsetray is a flexible notification service that allows you to send push notifications to your own devices or to devices belonging to others, like family members, coworkers, or employees. It features a persistent, searchable notification tray with attachments support, making it easy to integrate with custom scripts, servers, CI/CD pipelines, or platforms like Home Assistant.

Because Pulsetray is API-first, you can use it in any environment capable of making standard HTTP requests. We provide official integration documentation for platforms such as Home Assistant (Core and Node-RED), cURL, GitHub Actions, and more.

Our early initial release is currently available for Android, but an iOS app is definitely in the works and will be released soon. In the meantime, you can join our iOS waitlist to be the first to know when it launches!

Yes! There's a lot planned. Right now, we're keeping the roadmap flexible so we can focus on building the features you actually want to see. Got a suggestion or a specific use case? Send it over to support@pulsetray.com

We are always looking to improve! You can reach out with questions, feature suggestions, or bug reports by emailing us at support@pulsetray.com

Right now, account creation happens entirely within the app. Just download the Android app, tap sign up, and follow the setup steps on your screen.

Profiles are a way to organize recipients within your account. You can create a profile for a specific person and group their devices under it. This allows you to target notifications directly to that individual without broadcasting the alert to the entire account.

Devices represent the actual smartphones or tablets receiving notifications. Once onboarded, they get secondary access to your account (i.e. they can only receive notifications, but not manage your account). To add a device, go to Settings > Profiles and devices, and tap "Add device." The app generates a single-use Onboarding Token and Onboarding URL. Share these credentials with the recipient so they can securely link their device to your account.

They are a two-tier classification system for your notification history. A Source lets you identify the origin of the alert (e.g., "Home Assistant" or "GitHub Actions"), and a Category lets you narrow down the specific trigger (e.g., "Front Door" or "Deployment Failed"). This lets you see where a notification came from, why, and to filter accordingly.

If somebody deletes their app from their phone without explicitly tapping "Sign Out" first, the device will remain "Enrolled" in our system and they will not be able to sign in again. To give them their access back, you must add a new device, and have them onboard with the new Onboarding Token. You will also have to manually delete the old device to free up that slot.

System notifications are automatic alerts regarding your account activity, which are sent to your profile only. We currently trigger these when different actions occur, such as when someone signs into your account, a device is onboarded or registered, or when your subscription plan changes. They appear in your tray under the built-in "Pulsetray" source, so you can filter or search through them just like your own API alerts.

In the app, navigate to Settings > Manage profiles and devices. Tap on the profile you want to target, then select "Manage profile". You will see the Profile ID field with a button to copy it directly to your clipboard.

In the app, navigate to Settings > Manage profiles and devices and tap on the profile the device belongs to. Select the specific device from the list, and you will find the Device ID field with a copy button next to it.

Yes, Pulsetray offers a Free tier designed to get you started, and it provides enough monthly capacity for personal projects or small home automation setups.

Paid subscriptions are billed on a monthly cycle.

Upgrades take effect immediately, granting you higher limits instantly. If you upgrade from Free to a paid plan, you will also get fresh quotas. If you cancel a plan, it remains active until the end of your current billing period. If you downgrade to a plan with limits lower than your current usage (for example, having 10 devices on a Free plan), your existing data remains intact. However, the API will prevent sending new notifications until you delete the excess items to match your new limits.

If you hit your plan's storage limit, you won't be able to attach new images or videos to your notifications. To make room, you can free up space instantly by manually deleting older notifications that contain media, or you can let the automatic retention window clear them out over time.

API keys are unique, non-expiring tokens that authorize external services to send notifications to your account. You can create multiple keys to isolate different integrations (e.g., one for your smart home, another for your server backups) and revoke them individually if a service is no longer needed.

Authentication is straightforward and stateless. Simply generate an API Key in the app under Settings > API keys. Copy the provided token and include it in the Authorization header of all your API requests as a Bearer token (e.g., Authorization: Bearer YOUR_TOKEN). Tokens do not expire.

Android and iOS aggressively restrict background activity to save battery, making notifications arrive late, especially when the phone is not in use or when the screen is off. To fix this, make sure to pass high priority flags (androidConfig.priority = "high" or apnsConfig.priority = 10) in your JSON payload to wake the device immediately.

Absolutely. If you want a persistent log without the interruption, simply set the sendPush parameter to false in your API request. Pulsetray will skip sending the push notification to the device but will still save the record and any attached media into your searchable notification tray.