Loading...

Push Notifications

Push notifications are remote notifications that an application provider can send to the users of their application, even when the application is not actively running on the user device. Catalyst provides you with an easy way to integrate push notifications into your Catalyst web and iOS applications.

Send Web Push Notifications

Description

This API is used to send text push notifications to the users of your web application for testing, after you enable push notifications for it. You can enable push notifications and also register client devices for receiving push notifications by implementing the web script mentioned in this Web SDK help page. You can then use this API to send push notifications.

You can pass the push notification message and a list of the recipients in your API request as shown in the sample request.

Request Details

Request URL

POST

{api-domain}/baas/v1/project/{project_id}/project-user/notify

copy

api-domain
URL
The DC-specific domain to access Catalyst API

project_id
Numerical
The unique ID of the project

Request Headers

Content-Type: application/json

Optional Headers

CATALYST-ORG: {org_id}

Environment: Development

Note: Catalyst does not authenticate this API request. Therefore, you need not pass an OAuth token.

Scope

ZohoCatalyst.notifications.web.CUSTOM

Request JSON Properties

recipients string
mandatory
The email address or the user ID of the users that the push notification must be sent to
message string
mandatory
The message content of the push notification in the text format

Response Details

The response returns the status of the sent notification as success or failed.

Sample Request
copy

curl -X POST
https://api.catalyst.zoho.com/baas/v1/project/3000000002001/project-user/notify
-H “Content-Type: application/json”
-d ‘{ “recipients”:[“rhonda.wilkins@zylker.com”,“isabella.j@zylker.com”,“harry.sandman@zylker.com”], “message”:“Attention, new employees! Update your profile information in Zylker team app” }’

Sample Response
copy
{
"status": "success",
"data": true
}