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
  • Use Cases
  • Requirements
  • Example Request
  • Mobile App
  • Frequently Asked Questions
  1. OBJECTS
  2. Messages

Message

This is where you say what matters—the actual content your users need to see. Whether it’s an alert, a reminder, or a funny status update, the message field is what grabs attention.

  • No strict length limit (but practical limits apply for readability).

  • Supports line breaks for better formatting.

  • Works with emojis because everything is better with emojis. 😎

  • Plain text only—no markdown, HTML, or rich formatting.

Use Cases

The message can be used in many ways, from simple alerts to detailed reports. Here are some good examples:

Good Use Cases

✅ System Alerts: "Server CPU at 95%! Check logs now." ✅ Reminders: "Water the plants today!" ✅ Status Updates: "Your order #12345 has shipped!" ✅ Error Notifications: "❌ Backup failed! Check /logs for details."

Bad Use Cases

❌ Sending entire log files. ("Error 404. Error 405. Error 406. Error..." 😵) ❌ Writing an essay. (Nobody reads 10 paragraphs in a push notification.) ❌ Adding unsupported formatting. ("<b>Bold Text</b>" won’t work!)

Requirements

Attribute
Data Type
Validation Criteria

message

string

text

Example Request

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

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

How long can a message be?

There’s no strict limit, but shorter is better—users prefer quick, scannable content.

Can I use line breaks?

Yes! Line breaks work, so you can separate content for clarity.

Do emojis work?

Yup! All of them

Can I use HTML or markdown?

No, the message field only supports plain text.

PreviousTopicNextPriority

Last updated 1 month ago

Push Message with Title and Message