Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Create or modify Badge Reader Integration event handlers

Configure actions associated with a badge scan event and define the code to execute when a badge is scanned.

Before you begin

Role required: sn_badge.badge_admin

About this task

Using the Badge Event Handlers module you can map badge event handlers to multiple badge readers. For example, you may have a badge reader at your San Diego, CA walk-up location and another badge reader at your Santa Clara, CA location. Both of these badge readers can be mapped to the same Walk-up Badge Reader event.

Badge Event Handler records are delivered as part of the Walk-up Experience application-specific badge reader integrations.

Note:

The code entered in the Script field of the Badge Event Handler form is executed using a GlideScopedEvaluator in the BadgeScanProcessor.

Procedure

  1. Navigate to All > Badge Reader Integration > Badge Event Handlers.

    The Badge Event Handlers list appears and displays any existing badge event handlers.

  2. To modify an existing badge event handler, click on the name.

    Otherwise, to create a new badge event handler, click New.

  3. Enter a name for the badge event handler in the Name field.

    For example, Walk-up Badge Event.

  4. Enter details in the Short description field, if desired.

  5. Enter code after // your code goes here in the Script field.

Image omitted: BadgeEventHandlers.png
Badge event handlers script
Image omitted: BadgeEventHandlerCode.png
Badge event handler code
**Note:** The **Application** field is set to **Global** until you enter the code specifying Walk-up Experience application in the **Script** field and save or submit the record.
  1. Click Submit to create the record.

Parent Topic:Walk-up Experience Badge Reader Integration setup and configuration