Title

he title gives your topic a human-friendly name. It’s optional, but helps you (and your users) know what the topic is about. Think “Server Alerts” instead of “topic-abc123”.

---

The title is the display name of your topic. It doesn’t affect how messages are sent, but it does make your topic easier to recognize—especially when users are subscribing or managing multiple topics. Without a title, the topic will just show its unique ID (which, let’s be honest, looks like a Wi-Fi password).

A clear title helps give your topic purpose—whether it’s "Build Notifications", "Marketing Alerts", or "🚨 Emergency Updates". Use it to make your push ecosystem a little more human.

Use Cases

Good Ideas

Use topics to send messages to specific streams or audiences, without spamming everything and everyone.

✅ DevOps: "Staging Alerts", "Production Errors", "Deploy Logs" ✅ Projects: "Team Alpha Updates" vs. "Marketing Launches" ✅ Fun Stuff: "Dad Jokes of the Day" or "Cat Cam Alerts"

Bad Ideas

❌ Leaving the title blank. Nobody’s excited to subscribe to "topic-8f23a6b...".

❌ Using vague titles. "Stuff", "Misc", or "Things" doesn’t help anyone.

❌ Overusing emojis. "🚨🔥💥😱🧯💣⚠️" is fun once. Then it’s chaos.

❌ Naming every topic the same. "Alerts" for everything defeats the purpose of using topics at all.

Requirements

Attribute	Data Type	Validation Criteria
title	string	max 100

Example Request

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

---

Frequently Asked Questions

Is the topic title required?

Yup it is!

Can I change the title after creating the topic?

Yes! Use a PUT request to update the title anytime.

Does the title affect message delivery?

Not at all. It’s just for display—messages are still sent using the topic’s unique ID.

Can two topics have the same title?

Yes, titles aren’t unique. Just make sure you don’t confuse yourself (or your users).

Can I use emojis in the title?

Absolutely! Just don’t go full emoji salad. 🌽🍅🥕