Skip to main content

What are Categories?

Categories are used to tag notifications. For example, you can tag notification Hey, Anand commented on your photo in new_comment category. Grouping notifications under categories will help your users set preferences in receiving notifications from categories. See Preferences

Creating a Category

A category can be created using /category API endpoint, or through the dashboard (coming soon).

tip

When you include category parameter in the send /notifications API, we'll check if that category exists in your system. If not, we'll create it on the go.

Tagging a Notification

This is how you can tag a notification with a category identifier while sending it through REST API.

POST /notifications

{
"notification": {
"title": "Anand commented on your photo",
"message": "Hey Steve, you're looking cool 😎. Who took this photo?",
"url": "https://your-app.com/photos/17293739"
},
"category": "new_comment",
"recipients": ["[email protected]"]
}
warning

If you do not tag a notification in a category, it will not check the notification preferences set by your users, and the notification will be delivered to everyone.