Would you like to tell us how we are doing?

You bet No thanks

Sorry about the red box, but we really need you to update your browser. Read this excellent article if you're wondering why we are no longer supporting this browser version. Go to Browse Happy for browser suggestions and how to update.

Developing a push-enabled application

We provide a sample application that you can use to learn how to develop your own push-enabled application. The sample application shows you how to use the APIs in the client-side library to connect with the Push Initiator, and receive push messages on a BlackBerry device.

The sample application accepts push messages with the following types of content. The Push Service SDK automatically specifies the type of content in the header of the push message. In your application, you can send up to 8 KB of any type of content (images, text, or audio).

Type of content Content-Type HTTP header
Text text/plain
HTML text/html
Image image/jpeg, image/gif, image/png

To receive push messages, the sample application subscribes with the Push Initiator. If you don't want to use the Push Service SDK to write your Push Initiator, but you still want to use the sample application, you need to include some code in your Push Initiator that accepts the subscription request sent from the sample application, and returns an HTTP response back to the application. For more information about subscribing with the Push Initiator, see Registering to receive push messages.


Item Requirement
Server-side library
  • We recommend using the Push Service SDK with our sample push-enabled application, and with push-enabled applications that you develop.

    To use the Push Service with the BlackBerry Internet Service, you must register with Research In Motion. When you sign up, you receive a confirmation email message that contains information that your application uses to receive push messages. For more information about signing up, visit Push Service.

    If you plan to develop a push solution that delivers content using the BlackBerry Enterprise Server only, you don't need to sign up to use the Push Service.

Client-side library
  • BlackBerry Java Development Environment 5.0 or later
BlackBerry device
  • BlackBerry 7 and earlier
  • BlackBerry Internet Service
  • Data plan with your wireless service provider that provides a connection to the Wi-Fi network or mobile network.
Sample push-enabled application

The sample application depends on the BlackBerry Java Development Environment 5.0 or later.