Get started

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

SoundMeaning
defaultappkeepr's neutral notification tone; also used when sound is omitted.
successA successful operation or recovery.
errorA failed operation or payment problem.
cashA purchase or positive financial event.
attentionA warning or change worth checking.
alarmAn outage or serious problem.
noneNo 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:

SourceExamples
RevenueCatTrials use success; purchases and trial conversions use cash; refunds and payment failures use error; cancellations use attention.
Sentry Issue AlertsFatal events use alarm, errors use error, warnings use attention and informational alerts use default.
Sentry User FeedbackFeedback uses attention.
VercelProduction deployment failures use error; successful checks use success.
DokployFailed operations use error, successful operations use success and server threshold alerts use attention.
App Store ReleasesReady for distribution uses success; review rejection uses error; changes needing attention use attention; routine progress uses default.
UptimeDown uses alarm; recovery uses success.
Domains and TLSExpiry 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.

On this page