Add an email address and PIN to HTTP requests from the BlackBerry Mobile Data Service

by Retired on ‎02-17-2010 03:53 PM - edited on ‎10-31-2013 12:49 PM by BlackBerry Development Advisor (7,513 Views)



This article applies to the following:

  • BlackBerry® Mobile Data Service
  • BlackBerry® Browser





Note: This is not currently supported on BlackBerry Enterprise Server 10.


You can include a BlackBerry smartphone personal identification number (PIN) and email address to the Hypertext Transfer Protocol (HTTP) headers for requests originating from the BlackBerry Mobile Data Service.


In the file, under the [HTTP HANDLER] heading, do one of the following:

  • To add a PIN, add the following line:


  • To add an email address, add the following line:


  • To add both a PIN and an email address, add the following line:

    application.handler.http.header=email,pin (applies to BlackBerry Mobile Data Service 4.0 and later only)

If you want to keep the PIN and email address private, restrict the additional headers to specific domains. For example, to add headers to requests that are only destined for or domains, add the following line to the file:




           The two additional values are required for the root domain. and will not be   included in the specific domain list if only .+\.acme\.net;.+\.acme\.com are the listed values.



The headers will appear as follows:


     Rim-device-email: <user_name>


     im-device-id: <PIN>


Note: To include an email address in the HTTP headers, the BlackBerry Mobile Data Service relies on the PIN to email address mapping, which resides in the BlackBerry Configuration Database. Therefore, the BlackBerry Database Consistency Service must be running so that the PIN to email address mapping is kept up-to-date.



Additional Information


The file can usually be found in the following locations:


     For the BlackBerry Enterprise Server (BlackBerry Mobile Data Service)


  C:\Program Files\Research In Motion\BlackBerry Enterprise Server\MDS\Servers\<MDS Server Name>\config


     For the simulator


  C:\Program Files\Research In Motion\BlackBerry JDE 4.0\MDS\config