Thank you for your feedback.
Form temporarily unavailable. Please try again or contact to submit your comments.

Push notification setup with a custom push application

Log in to subscribe to topics and get notified when content changes.

Push notification setup with a custom push application

If you are using your own custom mobile or push application, you must configure your app for use and set up the push contents.

Setting up a push notification infrastructure that uses a custom push app involves a push admin (also called push app developer or mobile app developer) and system administrator. When push admins create a customized push app, they also configure the app, its push message content (payload generators), and optional attributes, such as push action scripts. The admin creates and updates the push notifications for the custom push app. After users install the custom push app and initially log in to their instance from their mobile device, the system automatically creates a device (channel) for the custom app.

Note: These instructions are intended for users who develop their own customized push application. You do not need to configure the ServiceNow mobile application.
Push notification setup tasks for a custom push app

Before you begin

Complete the steps in Activate push notifications. The Push Feedback ( plugin enables the system to receive push feedback from Apple and is required if you have an iOS app.

Assign the push_admin role to your organization's mobile app developer.

What to do — push admin

Configure push notifications for your custom push app. This process differs for iOS and Android devices.

  1. (iOS only) Upload a push certificate to your instance

    Upload a push certificate to your instance so that you can use it later to connect your iOS device to the push notification system.

  2. Create a push application record for your custom app

    Register your customized mobile application with your instance to receive push notifications for the application. The instance uses this push application record to identify the device + push application combination necessary to determine a push notification recipient.

  3. Create push message content

    Create a JSON content payload for different types of push notifications. The content determines how a push notification appears on the push application, and whether the user can send a message in response to the push notification. The push admin can create attribute definitions that specify a default push action script or string, for use in the push message content.

  4. (Optional) Create a push message attribute definition

    Push message attribute definitions allow you to create reusable properties for push message content specification.

  5. (Optional) Create an attribute value or action for a push message

    You can create attribute values that override the default attribute definitions used in the push message content.

  6. (Optional) Create a push action

    A push action is a server-side script that runs when the instance receives a response to an actionable push message.

What to do — admin

Create the push messages and push notifications
The administrator creates the push messages, sets up push notifications for the custom push app, and if desired, the content.

Next steps

Monitor push feedback to track push notifications that are failing to send to your custom push app. For more information, see Monitor push feedback.