Notification sounds
Give purchases, errors and other events a sound you'll recognize.
Add sound to a Messages API or Node.js SDK message. Integrations and monitors pick one automatically.
Presets
| Sound | Meaning |
|---|---|
default | appkeepr's neutral notification tone; also used when sound is omitted. |
success | A successful operation or recovery. |
error | A failed operation or payment problem. |
cash | A purchase or positive financial event. |
attention | A warning or change worth checking. |
alarm | An outage or serious problem. |
none | No sound. The message still appears in Inbox. |
Use any preset with any custom message. Send its lowercase name; null, empty strings and unknown names are rejected.
Send with cURL
Create a sales channel, then send a purchase message with cash:
curl https://appkeepr.com/api/messages \
-H "Authorization: Bearer $APPKEEPR_API_TOKEN" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: purchase-1044" \
-d '{
"channel": "sales",
"body": "Ada upgraded to Pro.",
"sound": "cash"
}'Send with Node.js
await appkeepr.messages.send(
{ channel: "sales", body: "Ada upgraded to Pro.", sound: "cash" },
{ idempotencyKey: "purchase-1044" },
);
await appkeepr.messages.send(
{ channel: "sales", body: "Daily summary is ready.", sound: "none" },
{ idempotencyKey: "summary-2026-10-07" },
);Keep the sound unchanged on retries. Changing it with the same idempotency key returns 409.
Automatic choices
A few examples of how appkeepr picks sounds:
| Source | Examples |
|---|---|
| RevenueCat | Trials use success; purchases and trial conversions use cash; refunds and payment failures use error; cancellations use attention. |
| Sentry Issue Alerts | Fatal events use alarm, errors use error, warnings use attention and informational alerts use default. |
| Sentry User Feedback | Feedback uses attention. |
| Vercel | Production deployment failures use error; successful checks use success. |
| Dokploy | Failed operations use error, successful operations use success and server threshold alerts use attention. |
| App Store Releases | Ready for distribution uses success; review rejection uses error; changes needing attention use attention; routine progress uses default. |
| Uptime | Down uses alarm; recovery uses success. |
| Domains and TLS | Expiry warnings use attention; critical expiry or certificate problems use alarm; recovery uses success. |
Device support
Custom tones need an up-to-date appkeepr app and, on Android, Android 8+. Older apps and browsers use the OS default tone.
Silent messages on web and older Android apps
none skips push on browsers and Android devices without silent notification
support. The message still reaches Inbox. Updated native apps can receive it
as a silent push.
Your device's notification, mute and Focus settings still apply. Even alarm won't bypass Do Not Disturb.