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

Push Message with Title and 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.

Last updated