---
schema_version: "1"
id: 9054cd938e79796bc2bbb69c3fd1702b8836f98f716169c2bded3919f7012c91
title: Send Custom Notifications with Notification Builder Platform
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/xcloud/264-0-0/connected_app_notifications_custom.md
canonical_url: https://help.salesforce.com/s/articleView?id=xcloud.connected_app_notifications_custom.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: fc2a54f3c26600ef123daaffa33db0d9f0f1cc7c794df4ca827f6379eb399845
description: Subscribe your connected apps to custom notification types to receive and display in-app and push notifications. Subscribing allows you to send custom notifications to users in your own org. Or you can package your app for distribution and the custom notifications it subscribes to along with it, including the notification types and triggers.
products:
  - Security
  - Cross Cloud
release: "264"
---
# Send Custom Notifications with Notification Builder Platform

Subscribe your connected apps to custom notification types to receive and display in-app and push notifications. Subscribing allows you to send custom notifications to users in your own org. Or you can package your app for distribution and the custom notifications it subscribes to along with it, including the notification types and triggers.

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition">
        <colgroup>
          <col>
        </colgroup>
        <tbody>
          <tr class="">
            <td class="slds-cell-wrap" style="vertical-align:top;">Available in: Lightning Experience</td>
          </tr>
          <tr class="">
            <td class="slds-cell-wrap" style="vertical-align:top;">
              <p>Connected Apps can be created in: <strong>Group</strong>, <strong>Essentials</strong>,
                <strong>Professional</strong>, <strong>Enterprise</strong>, <strong>Performance</strong>, <strong>Unlimited</strong>, and
                <strong>Developer</strong> Editions
              </p>
              <p style="margin-bottom:0;">Connected Apps can be installed in: <strong>All</strong>
                Editions</p>
            </td>
          </tr>
        </tbody>
      </table> <table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small permission">
        <colgroup>
          <col style="width:50%">
          <col style="width:50%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="colgroup" class="slds-cell-wrap" colspan="2" style="text-align:center;vertical-align:top;" id="d41955e64">User Permissions Needed</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d41955e64 ">To read, create, update, or delete connected apps:</td>
            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d41955e64 ">
              <p>Customize Application AND either</p>
              <p style="margin-bottom:0;">Modify All Data OR Manage Connected
                Apps</p>
            </td>
          </tr>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d41955e64 ">To update all fields except Profiles, Permission Sets, and Service Provider SAML
              Attributes:</td>
            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d41955e64 ">
              <p>Customize Application AND either</p>
              <p style="margin-bottom:0;">Modify All Data OR Manage Connected
                Apps</p>
            </td>
          </tr>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d41955e64 ">To update Profiles, Permission Sets, and Service Provider SAML Attributes:</td>
            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d41955e64 ">Customize Application AND Modify All Data AND Manage Profiles and Permission
              Sets</td>
          </tr>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d41955e64 ">To rotate the consumer key and consumer secret:</td>
            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d41955e64 ">Allow consumer key and secret rotation</td>
          </tr>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d41955e64 ">To install and uninstall connected apps:</td>
            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d41955e64 ">
              <p>Customize Application AND either</p>
              <p style="margin-bottom:0;">Modify All Data OR Manage Connected
                Apps</p>
            </td>
          </tr>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d41955e64 ">To install and uninstall packaged connected apps:</td>
            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d41955e64 ">
              <p>Download AppExchange Packages AND Customize Application AND either</p>
              <p style="margin-bottom:0;">Modify All Data
                OR Manage Connected Apps</p>
            </td>
          </tr>
        </tbody>
      </table>

![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-identity-264-0-0-production-enus/699dab6f-8f1a-4662-b24f-6521d5b747f7/images/icon_note.png)

Note Connected apps creation is restricted as of Spring ‘26. You can continue to use existing connected apps during and after Spring ‘26. However, we recommend using [external client apps](https://help.salesforce.com/s/articleView?id=xcloud.external_client_apps.htm&language=en_US) instead. If you must continue creating connected apps, contact Salesforce Support.

See [New connected apps can no longer be created in Spring ‘26](https://help.salesforce.com/s/articleView?id=005228017&type=1&language=en_US) for more details.

Before you begin, make sure that the custom notification type you want to subscribe to exists and that the appropriate supported channels are enabled for the type. If not, [create or edit the notification type](https://help.salesforce.com/articleView?id=notif_builder_custom_type.htm&language=en_US). You can manage your custom notification types via the Custom Notifications page in Setup or via [API](https://help.salesforce.com/articleView?id=notif_builder_custom_other.htm&language=en_US).

1. Enter Apps in the Quick Find box in Setup, then select **App Manager**.
2. Locate the desired app, then select **Edit** from the dropdown menu.
3. Select **Enable subscription to notification types**.
4. Select the desired subscription options for each custom notification type.
    
    - **Subscribe** — Enables the connected app for the notification type. Notifications are returned via API and can be used to populate a connected app's notification tray, if available.
    - **Send as Push** — Enables mobile push notifications for the notification type. To enable push notifications, you must also select **Subscribe**.
5. Save your changes.

You can subscribe a connected app to a custom notification type before you associate triggers with the type. However, you must associate triggers with a type to send a custom notification. To associate triggers with a custom notification type, add it to a [process](https://help.salesforce.com/articleView?id=notif_builder_custom_process.htm&language=en_US) or [flow](https://help.salesforce.com/articleView?id=notif_builder_custom_other.htm&language=en_US), or use the [customNotificationAction](https://developer.salesforce.com/docs/atlas.en-us.api_action.meta/api_action/actions_obj_custom_notification.htm).

Use the [Connect REST API Notifications Resources](https://developer.salesforce.com/docs/atlas.en-us.chatterapi.meta/chatterapi/connect_resources_notifications_resources.htm) to get, update, and get the status of custom notifications in your org.

Use the [Connect REST API Notification Settings Resources](https://developer.salesforce.com/docs/atlas.en-us.chatterapi.meta/chatterapi/connect_resources_notification_settings_resources.htm) to get, set, and reset your org’s notification settings.

- **[Notification Builder Platform Push Payloads](https://help.salesforce.com/s/articleView?id=xcloud.connected_app_custom_push_payload.htm&release=264.0.0&type=5)**  
    Learn about how we handle push payload content for custom notifications.