by jeremywrags


Journey Builder Activity Template

Starter template for a messaging JB Activity using Node.JS

NOTE: This app and the associated code is NOT production quality, its pure purpose is to demonstrate the full flow of custom interactions in Journey Builder


  • Node.js (if you'd like to test locally)
  • A Marketing Cloud Account with Journey Builder
  • A publicly accessible web server (this template was built using a free Heroku account with SSL support

Configure your package in Marketing Cloud

  1. Login to Marketing Cloud and Navigate to Administration > Account > Installed Packages
  2. Click on New and enter a name and a description for your package
  3. Copy the JWT Secret value from the Summary page and save it for later
  4. Click on Add Component, select Journey Builder Activity and Click next
  5. Enter the information about the activity, enter [url of your activity] as your Endpoint URL
  6. Click Save
  7. Copy the Unique Key value from the Journey Builder Activity panel and save it for later

Configure Activity

  1. Open /public/config.json and:
  • Replace application_key_from_appcenter_here for the value you got from step 7 from the previous section
  • Replace [your-domain-here] with the domain for your website
  1. Open /public/images and replace with the icons for the activity to your liking


Add Heroku vars

  1. Log back into Heroku and navigate to your app
  2. Click on "Settings"
  3. Click on "Reveal config vars"
  4. Add a new var called jwtSecret and paste the App Signature you got from step 3 when configuring your package in Marketing Cloud

Testing your Activity

  1. Login into Marketing Cloud and navigate to Journey Builder
  2. You should be able to see your custom activity and drag it into the canvas!

Want to learn more?

If you'd like to learn more about building custom Journey Builder Activities and our collection of Custom Activities available to you today, email us at

Also, follow us on LinkedIn to get the latest updates and great articles about Salesforce Marketing Cloud!