Newer Version Available

This content describes an older version of this product. View Latest

iOS Custom Push Payload Content

Use these keys and values to create custom iOS push notifications for your connected app.
Available in: Lightning Experience
Connected Apps can be created in: Group, Essentials, Professional, Enterprise, Performance, Unlimited, and Developer Editions

Connected Apps can be installed in: All Editions


Table 1. APS Dictionary Keys
Payload Key Description Value
sound Sound played on alert display. default
badge Number displayed in a badge on your app’s icon. Count of unseen notifications
mutable-content

Indicates payload content that requires handling by the notification extension.

Included with encrypted payloads only.

true
Table 2. Alert Dictionary Keys
Payload Key Description Value
title

Alert title. Displayed by default for iOS remote notifications

For encrypted payloads, the MSDK notification extension extracts and displays the custom alertTitle key value supplied in encrypted content.

Empty string
body Alert body. Displayed by default for iOS remote notifications

The custom notification title is supplied as the value for this key for use in a body-only alert, in case of MSDK notification extension failure only.

Table 3. Custom Keys
Payload Key Description Value
content

Encrypted payload content

See the Encrypted Content Keys table for content details.

AES encrypted and base64 encoded payload content
secret Symmetric encryption key RSA encrypted and base64 encoded AES key and IV bytes
encrypted Encrypted payload indicator true
Table 4. Encrypted Content Keys
Payload Key Description Value
oid Organization ID ID of org where notification originated
uid Recipient User ID ID of notification recipient
nid Notification ID ID of the notification
type Notification type class -1
sid Source ID ID of record associated with notification
rid Related ID N/A (reserved for future use)
cid Community ID ID of community for the notification
notifType Notification type ID ID of the custom notification type
alertTitle Notification alert title
  • If full content push notifications are enabled for the app: Custom notification title
  • If full content push notifications aren’t enabled for the app: Empty string
alertBody Notification alert body
  • If full content push notifications are enabled for the app: Custom notification body
  • If full content push notifications aren’t enabled for the app: Custom notification title