JustPush.io
  • Introduction
  • New? Start Here
  • The Glossary
  • USER MANUAL
    • Getting Started
    • API Key
    • JustPush Email
  • OBJECTS
    • Messages
      • Title
      • Topic
      • Message
      • Priority
      • Sounds
      • Images
      • Acknowledgements
      • Buttons
      • Button Groups
      • Expiry TTL
    • Topics
      • Title
      • Avatar
  • DEV TOOLS
    • API reference
      • Messages
      • Topics
    • OpenAPI
    • Rapid API
    • Postman
    • SDKs
    • Changelog
Powered by GitBook
On this page
  • Available Sounds
  • Use Cases
  • Requirements
  • Example Request
  • Mobile App
  • Frequently Asked Questions
  1. OBJECTS
  2. Messages

Sounds

You can pick a custom sound for each notification, so your messages can be subtle, alarming, or just plain fun. Choose from a list of built-in sounds, or set the default to keep things quiet. 🔊🎵


Why settle for a generic ding when your server outage could scream "SIREN!"? JustPush.io offers a variety of built-in sounds to give your notifications more personality. Whether you want a soft chime for reminders or an air raid siren for critical alerts, there’s a sound for every occasion.

  • Customizable: Pick a sound from the our library sound library.

  • Silent Option: Prefer peace and quiet? Set it to "none" for a vibration-only alert.

  • Per-Message Control: Each notification can have a different sound.

Available Sounds

Type

NONE

DEFAULT

BIKE

CASHREGISTER

CLASSICAL

COSMIC

FALLING

GAMELAN

INCOMING

INTERMISSION

MAGIC

MECHANICAL

PIANOBAR

SIREN

SPACEALARM

TUGBOAT

ALIEN

CLIMB

PERSISTENT

ECHO

UPDOWN

VIBRATE

Use Cases

Sounds help you instantly recognize the importance of a notification—whether it’s an emergency, a new sale, or just a friendly reminder. Here’s how you can use them effectively:

Good use cases

✅ Server Down Alert: Play "siren" to wake up in a panic. 🚨 ✅ New Order Received: Use "cashregister" to celebrate. 💰 ✅ Daily Motivation: Set "magic" for a little extra inspiration. ✨

Bad use cases

❌ Using "siren" for every notification. (Your nerves will hate you.) ❌ Setting "none" for critical alerts. (Don’t blame Pushover if you miss it.)

Requirements

Attribute
Data Type
Validation Criteria

sound

string

Should be specified in the library

If you sound is left empty, the default sound will be used.

Example Request

curl -X "POST" "https://api.justpush.io/messages" \
     -H 'Content-Type: application/json; charset=utf-8' \
     -d $'{
  "user": "<< USER KEY >>",
  "title": "A simple title",  
  "message": "A simple test message",
  "sound": "COSMIC",
}'

Mobile App

Below you see an example of how this displayed as a push message and within the app.

Push Message

Within JustPush.io App


Frequently Asked Questions

Can I upload my own sounds?

Nope! Only JustPush.io built-in sounds are available.

What happens if I set an invalid sound?

We will return a validation error and the message will not be processed.

Does sound work if my phone is in silent mode?

Nope—your phone’s settings always take priority.

PreviousPriorityNextImages

Last updated 1 month ago

Push Message with Title and Message
Message with prioritiy