Skip to Content
Technical Articles
Author's profile photo Enric Castella

Send push notification to SAP BTP Launchpad via HTTP

In many cases, a basic requirement of our applications is to be able to notify the user of any update in the system centrally.

We only had several options in the past to show tasks to the user: KPIs in a dynamic tile, customized plugin or receiving feedback after talking with a bot via SAP conversacional AI.

With the notification service in the SAP BTP launchpad, we can now give feedback to the user and allow them to take quick actions.

We will see how to configure our launchpad, add a type of notification and finally generate a notification via request. With these steps we can integrate e.g. other applications outside SAP, the SAP integration Suite or any other backend that uses Http protocol…

Initial configuration

Generating the notification service in SAP BPT

The first thing to do is to access the launchpad configuration page to generate and activate the notification service in lauchpad.

On the notifications page you will see the option to generate the service, so as you can imagine, we are going to click on the “generate” button.

Once the service has been generated, details will appear on the notifications page:

Showing notifications

The next step is to enable the notifications option in the launchpad settings.

In the configuration page we will activate the option to show notifications to the user:

Getting permission to make the notification

The first thing to do before performing any operation is to obtain the two tokens that we will use to send data. The first is the Bearer token, which gives us the authorisation to use the API and a second token called x-csrf-token which we will use to make POST requests.

Obtaining the Bearer token

To obtain the data we will use the url that shows us the launchpad configuration:

We will add this parameter to the URL at the end to indicate that we will use the client credentials mechanism.


Next will be the credentials, which we will also have in the launchpad configuration.

With this data we can now generate the token. This is the example of the data we would use in postman:

And this is a little trick to read the answer and add it in an environment variable.

Obtaining x-csrf-token

This token is used to make POST, so for get operations it is not necessary, and that is why we will make a GET request to obtain it.

In this case we will use the following URL:

As authorization we will add the bearer token obtained in the previous call. We can add the variable.

We will add the token request: x-csrf-token = fetch

Although the response returns an error, the interesting thing is to extract the token from the response headers:

This token will have to be requested when making a Post.

Sending notifications

To continue with the example, we will create a notification type to alert users that a new application is available on their launchpad.

Creating a notification type

Now we will create a fairly simple notification, i.e. with a message without variable data.

We will use the following URL: and add the bearer and x-csrf-token obtained in the previous step:

And this will be the body that we will pass to it.

Where we generate an ID, a version and the text of the push notification.

The ones we will see in the launchpad when we click on the bell are TemplateSensitive and Subtitle, if we access by type, we will see templategrouped and as popup text we will see the value of public template.

    "NotificationTypeKey": "NewApp",
    "NotificationTypeVersion": "0.1",
    "Templates": [
            "Language": "en",
            "TemplatePublic": "New application is ready",
            "TemplateSensitive": "New application!",
            "TemplateGrouped": "The new application is ready",
            "TemplateLanguage": "Applications",
            "Subtitle": "Application notification"

Now we are all set. Let’s send a notification.

Sending a notification

To send notifications we will need to add the bearer token and the x-csrf-token as in the previous case.

To send the notification we will use this URL: and this is the body that we will send:

    "OriginId": "test",
    "NotificationTypeKey": "NewApp",
    "NotificationTypeVersion": "0.1",
    "Priority": "Low",
    "Recipients": [
            "RecipientId": ""

As we can see, we must add the email of the users we want to notify, for me this is a bug because as in the workflows topic, the field should be able to accept mails or groups.

Finally this is the result:

And here are some references to connect the service to a S4Hana system and to integrate with a ui5 application in an easy way.:

In conclusion, with this service you can add push notifications in the lauchpad + SAP Mobile Services Client. It’s important to provide this type of services for your user because we can redirect the user’s focus to their day-to-day tasks, and allow them to complete it with a few clicks.

Remember that the priority of any improvement is our users šŸ˜‰

Please check or rise your question on this blog or in the following tag in the Q&A section:

Assigned Tags

      You must be Logged on to comment or reply to a post.
      Author's profile photo Palina Krauchuk
      Palina Krauchuk


      Thank you for this post. I'm learning the Notification service now. I want to create and send a Notification also from Postman. I generated and set Bearer token and x-csrf-token, created a NotificationType, but then I was faced with some issues:

      1. When I try to perform GET

        in the Postman there is an issue like "Not implemented", so I'm not able to see current Notifications. Is it correct behaviour? (But POST call to create Notification was successful)

      2. When I checked the launchpad, there are no Notifications, but I see NotificationTypes in the User SettingsĀ 

      Do you have an idea why Notifications don't appear?

      Thanks and Best regards,


      Author's profile photo Enric Castella
      Enric Castella
      Blog Post Author

      Hi Paulina,


      Related with the point 1 if you use trial account most likely it will not work for eu10 and you will have to migrate to US for example.

      Point one probably affects point 2.



      Author's profile photo Sylvia Guirguis
      Sylvia Guirguis

      check the content-type paramter. It should be declared as application/json in the Header of the POST Request.

      Author's profile photo Luiz Gomes
      Luiz Gomes

      Where can I find the endpoint documentation? I have the following error: Illegal argument for method call with message 'Templates'
      when sending a POST with the notification data
      Author's profile photo Sylvia Guirguis
      Sylvia Guirguis


      How to implement for a user-group or role collection?

      "Recipients": [
                  "RecipientId": ""




      Author's profile photo VIKASH KUMAR
      Hi Enric Castella,
      I followed the steps as per this blog and document (
      I am getting error 500 with message "Failed to create notification" while sending notifications. Can you please help and suggest something.