Title

The title is the optional headline of your message. It grabs attention and adds context. If omitted, the app’s name is used instead. Keep it short, clear, and engaging—emojis welcome! 🚀

---

Think of the title as your message’s opening act. It sets the stage and gives context before the recipient even glances at the actual message. If you leave it out, don’t worry—JustPush.io will automatically use the app’s name instead (but come on, you can do better than that).

A great title is short, punchy, and informative. Something like:

✅ 🚨 Server Down! Panic Mode Activated ✅ 🔥 New Order #12345 – Time to Celebrate ✅ 🤖 Your Automation Just Did a Thing

Avoid titles like:

❌ "Message" (Wow, inspiring.) ❌ "Notification" (We gathered that already.) ❌ "Important Update" (Important to who?)

Requirements

Attribute	Data Type	Validation Criteria
title	string	max 255 characters

If a push message includes only a title, the body will default to "Empty."

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

A message with only a title will look like this.

A simple message with title an

---

Frequently Asked Questions

Is the title required?

Uhm, yes, but this also the only piece that we made required. We love to keep things simple.

How long can the title be?

At maximum it can be 255characters. But honestly, if you’re writing a novel in the title, you might need to rethink your approach.

Can I use Emoji's?

Absolutely! Emojis make everything better. Just don’t overdo it. "🔥🔥🔥🔥🔥🔥🔥🔥🔥🔥🔥🔥🔥🔥🔥🔥" might grab attention, but it won’t make you any friends.

What if I forget to set an title?

Nothing breaks, but your message might lack context. Your future self might not appreciate the mystery.