Skip to Content
Technical Articles
Author's profile photo yasuyuki uno

SAP Cloud Platform Alert Notification custom alerts from Node.js app in Cloud Foundry

If you want to send an email from CF web application, you have several options.

The 3rd option, Alert Notification possibles send email without SMTP server.

I tried send an email with Alert Notification from CF Node.js app, so I will show you how to do it step by step.

See this article for an overview of custom alerts.

You will know..

  • How to configure SAP Cloud Platform Alert Notification.
  • How to send a custom alert from Node.js.

Estimated time

  • 40 minutes

Appendix: About SAP Cloud Platform Alert Notification

Alert Notification offers platform alerts and notifications for resources in the SAP Cloud Platform and gives you the possibility to create custom alerts for these resources.
This GA released at June 2019.


Outline of the procedure

  1. Configure the Alert Notification.
  2. Acquiring API Access Credentials.
  3. Create a Node.js project.
  4. Run the app locally.
  5. Deploy the app to CF.
  6. Run the app on CF.


1.Setting up the Alert Notification for Initial Use.

Navigate to the Instances tab in the cockpit and click the New Instance button.

This time, I set the instance name as “alertinstance”.

Navigate to the Subscriptions tab in the cockpit and click the Create button.

This subscription name is not important. Any name is ok.

The Condition name, I set “EventTypelsCustomAlert” this time.

The below setting is important. I set “eventType is Equal To mycustomevent”.

Select the action type Email to send an email message to a specified email address and then choose Next.

After you created this action, receive an email with confirmation token.

In the Actions view, open your action and click Confirm Action button. Input your token there.

2.Acquiring API Access Credentials.

To enable interactions with the Producer API , you need to create a service key.

You also have to option to import a JSON containing the one of the following parameters:
{"type":"BASIC"} - use for creating basic authentication credentials
{"type":"OAUTH"} - use for creating OAuth 2.0 credentials
In this time, we use Basic authentication.

Navigate to the Service Keys tab and click Create Service Keys button.

3.Create a Node.js project.

Open Command Prompt and move to your workspace directory. In my case, the workspace is “D:\html5”.

cd /d D:\html5

Install the express generator. Express is the most popular Node.js framework.

npm install express-generator -g

Generate new project.

express -e alertnode

Move to your project directory and edit package.json.

cd alertnode

■package.json (added request module).

  "name": "alertnode",
  "version": "0.0.0",
  "private": true,
  "scripts": {
    "start": "node ./bin/www"
  "dependencies": {
    "cookie-parser": "~1.4.4",
    "debug": "~2.6.9",
    "ejs": "~2.6.1",
    "express": "~4.16.1",
    "http-errors": "~1.6.3",
    "morgan": "~1.9.1",
    "request": "*"

Then install dependencies.

npm install

Then edit app.js
Copy the following code and use it.
Please change <YOUR_BASIC_USER>  place to your basic auth user id.
Please change <YOUR_BASIC_PASS> place to your basic auth password.


var createError = require('http-errors');
var express = require('express');
var path = require('path');
var cookieParser = require('cookie-parser');
var logger = require('morgan');
var request = require('request');

var indexRouter = require('./routes/index');
var usersRouter = require('./routes/users');

var app = express();

// view engine setup
app.set('views', path.join(__dirname, 'views'));
app.set('view engine', 'ejs');

app.use(express.urlencoded({ extended: false }));
app.use(express.static(path.join(__dirname, 'public')));

app.use('/', indexRouter);
app.use('/users', usersRouter);

app.use("/api/notify", function(req,res,next){

	var options = {
	  url: '', // Endpoint URL + "/cf/producer/v1/resource-events"
	  method: 'POST',
	  auth: {
	    user: "<YOUR_BASIC_USER>", // Change here.
	    password: "<YOUR_BASIC_PASS>"  // Change here.
	  json: {
			  "eventType": "mycustomevent",
			  "resource": {
			    "resourceName": "Your Node.js App.",
			    "resourceType": "app",
			    "tags": {
			      "env": "develop environment"
			  "severity": "FATAL",
			  "category": "ALERT",
			  "subject": "Something is wrong.",
			  "body": "Hello world",
			  "tags": {
			    "ans:correlationId": "30118",
			    "ans:status": "CREATE_OR_UPDATE",
			    "customTag": "42"

	// Send request
	request(options, function (error, response, body) {

		res.send('Send E-mail Notification.');


// catch 404 and forward to error handler
app.use(function(req, res, next) {

// error handler
app.use(function(err, req, res, next) {
  // set locals, only providing error in development
  res.locals.message = err.message;
  res.locals.error ='env') === 'development' ? err : {};

  // render the error page
  res.status(err.status || 500);

module.exports = app;

4.Run the app locally.

Run the application by

npm start
> alertnode@0.0.0 start D:\html5\alertnode
> node ./bin/www

Open your browser and access http://localhost:3000/api/notify

You will receive an email from Alert Notification.

Next, we’ll deploy this app to your CF environment and run on cloud.


5.Deploy the app to CF.

Using CF CLI, login and deploy the app into Cloud Foundly.

cf api
cf login

# Deploy command.
cf push alertnode
Pushing app alertnode to org XXXXXXXX.XXXXXXXX / space dev as
Getting app info...
Updating app with these attributes...
  name:                alertnode
  path:                D:\html5\alertnode
  buildpack:           nodejs
  command:             npm start
  disk quota:          1G
  health check type:   port
  instances:           1
  memory:              1G
  stack:               cflinuxfs3

Updating app alertnode...
Mapping routes...
Comparing local files to remote cache...
Packaging files to upload...
Uploading files...
 1.40 MiB / 1.40 MiB [=====================================================================================] 100.00% 6s

Waiting for API to complete processing files...

Stopping app...

Staging app and tracing logs...
   Downloaded app package (1.8M)

Now it works on your CF space.

6.Run the app on CF.

Click the application routes URL.

Edit the address bar manually and press ENTER key.

You will get an email from Alert Notification.

Assigned Tags

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

      Hello @yasuyukiuno,

      first of all thank you for this awesome blog you have created ! It contains just the right steps for one to start using the Alert Notification service. I just wanted to outline that it's possible to also use the service to "broadcast" messages to multiple channels at the same time. Never to forget that the service comes with native support for Slack messages (incl. Slack threads) as well as generic web hooks with support for basic authentication, OAuth 2.0 and URLs with security token included into them.

      Best Regards,

      Author's profile photo yasuyuki uno
      yasuyuki uno
      Blog Post Author

      Hello Martin

      thanks for  comment. I know the Alert Notification supports Slack.
      However, our customer doesn't use Slack now. They are considering notify via email or via JIRA.
      So I triied email notification in this blog.
      Next time, I will try to integrate Alert Notification with JIRA.
      (webhook + OAuth + JIRA API)

      Yasuyuki Uno

      Author's profile photo Kiril Gavrailov
      Kiril Gavrailov

      Hi Yasuyuki Uno,

      thanks for the nice blog post?

      We are currently working on out-of-the-box JIRA integration. I will keep you posted once this is done.

      Also if you have any questions, don’t hesitate to get in touch with me.



      Author's profile photo Cedric Heisel
      Cedric Heisel


      Just for the next one who is searching this "subsctiption" and "action" buttons on the new Cloud Foundry UI for service-instances ... you need to click on "See here":

      Then you'll be on the "old-view", like the ones attached to this great blog post.


      Thanks again to yasuyuki uno

      Author's profile photo Fatema Patel
      Fatema Patel

      Hello, @yasuyuki uno

      Thanks for this excellent blog it helps a lot to learn a custom node.js app with Alert Notification.

      I did the same thing for many apps but when I was working with my Trial account at that time in response I was getting {code: 401, message: "Unauthorized"} so will this work with the BTP Trial account?

      request(options, function (error, response, body) {
      	console.log(response.body); //{code: 401, message: "Unauthorized"}
      	res.send('Send E-mail Notification.');