Push Notifications API¶

Use the Push Notifications API to send push notifications to users’ devices running native iOS and Android App Catalogs. You can send three types of push notifications:

Application Message: An application message push notification goes to devices which have downloaded the specified app.
Application Update Notification: When you upload a new version of an application, an application update notification goes to devices onto which users have downloaded the previous version of the application.
Group Message: A group message push notification goes to devices of all members of the specified group.

Note

Push notifications are supported with native App Catalogs only. Users running an HTML5 App Catalog will not receive push notifications from Apperian.

Resources¶

POST /v1/notifications/applications/(application)/message¶

Send Application Message

Requires administrator privileges. Authenticate as an Apperian administrator.

Sends an application message push notification to devices onto which an App Catalog user has downloaded the application.

This triggers a user notification on the device that, when tapped by the user, displays the name of the application and the message.

URLs

Environment	URL
North America	https://na01ws.apperian.com/v1/notifications/applications/<application>/message
Europe	https://eu01ws.apperian.eu/v1/notifications/applications/<application>/message

URL Parameters

application: (Required) Unique ID assigned by Apperian to the application. DATA TYPE: string

Header Parameter

X-TOKEN: (Required) API token or User token (POST /users/authenticate). For more information, see Authentication.
Content-Type: (Required) Specifies the content type of the body of data sent with the request. Set to: application/json

Data Parameters

message: (Required) UTF-8-compatible message string. Maximum characters: 150

Example Request

curl -X POST https://na01ws.apperian.com/v1/notifications/applications/23/message \
     --header "Content-Type: application/json" --header "X-Token: eTg8ktZXRqKIBJTHanwP6A" \
     --data '{"message": "Please log in to your App Catalog to install the latest version of the Sales Tracker app."}'

Example Response

{
     "app_message_notification_sent": True
}

POST /v1/notifications/applications/(application)/update¶

Send Application Update Notification

Requires administrator privileges. Authenticate as an Apperian administrator.

Sends an application update push notification to devices onto which App Catalog users have downloaded a previous version of the application.

This triggers a notification on the device that, when tapped by the user, opens the App Catalog. From the App Catalog, the user can install the update.

URLs

Environment	URL
North America	https://na01ws.apperian.com/v1/notifications/applications/<application>/update
Europe	https://eu01ws.apperian.eu/v1/notifications/applications/<application>/update

URL Parameters

application: (Required) Unique ID assigned by Apperian to the application. DATA TYPE: string

Header Parameter

X-TOKEN: (Required) API token or User token (POST /users/authenticate). For more information, see Authentication.
Content-Type: (Include only if sending a data parameter) Specifies the content type of the body of data sent with the request. Set to: application/json

Example Request

curl -X POST https://na01ws.apperian.com/v1/notifications/applications/68/update \
     --header "X-Token: eTg8ktZXRqKIBJTHanwP6A"

Example Response

{
     "update_notification_sent": True
}

POST /v1/notifications/groups/(group)/message¶

Send Group Message

Requires administrator privileges. Authenticate as an Apperian administrator.

Sends a group message push notification to devices owned by users belonging to a specific group. This triggers a user notification on the device that, when tapped by the user, displays the name of the group and the message.

URLs

Environment	URL
North America	https://na01ws.apperian.com/notifications/v1/applications/<group>/message
Europe	https://eu01ws.apperian.eu/notifications/v1/applications/<group>/message

URL Parameters

group: (Required) Unique ID assigned by Apperian to the group whose members you want to send the message. This ID is returned by the GET /groups/ resource. DATA TYPE: string

Header Parameter

X-TOKEN: (Required) API token or User token (POST /users/authenticate). For more information, see Authentication.
Content-Type: (Required) Specifies the content type of the body of data sent with the request. Set to: application/json

Data Parameters

message: (Required) UTF-8-compatible message string. Maximum characters: 150

Example Request

curl -X POST https://na01ws.apperian.com/notifications/groups/23/message \
     --header "Content-Type: application/json" \
     --header "X-Token: eTg8ktZXRqKIBJTHanwP6A" \
     --data '{"message": "Please log in to the App Catalog to install the Sales Tracker app."}'

Example Response

{
     "group_message_notification_sent": True
}