Use legacy listener transform scripts

  • Release version: Zurich
  • Updated July 31, 2025
  • 1 minute to read

    • Use legacy listener transform scripts when upgrading a ServiceNow AI Platform instance from Paris or earlier. These scripts can be run as part of existing integrated systems, or in unison with Event Management push connectors.

    You can use listener transform scripts to ensure that previous integrations are supported. For example, if you are using the https:/<instance-name>.service-now.com/api/global/em/inbound_event endpoint in various existing integrations, you can continue to use this endpoint in a Quebec or later ServiceNow AI Platform instance.

    If you want to use the Event Management push connectors, download the plugin from the ServiceNow Store website. You can then access the push connectors in the ServiceNow AI Platform instance, and the https://<instance-name>.service-now.com/api/sn_em_connector/em/inbound_event endpoint is also created.

    Use the legacy endpoint with push connectors

    You can continue to use the https:/<instance-name>.service-now.com/api/global/em/inbound_event endpoint with the push connectors, by deactivating the relevant transform scripts. To deactivate a script, navigate to Event Management > Integrations > Listener Transform Scripts. Then click the relevant script in the displayed list, and clear the Active check box in the form.

    Use the legacy endpoint and deactivate all listener transform scripts

    You can also continue to use the https:/<instance-name>.service-now.com/api/global/em/inbound_event endpoint but deactivate all listener transform scripts to use the push connectors instead. To deactivate all scripts, navigate to System Properties > All Properties, locate the sn_em_connector_listener_table_for_InboundEvent property, and set its value to True.

    Migrate custom listener transform scripts to the push connectors module

    If you have created custom listener transform scripts, they must be migrated to the push connectors module if you want to use the new https://<instance-name>.service-now.com/api/sn_em_connector/em/inbound_event endpoint. To migrate the custom script, navigate to Event Management > Integrations > Listener Transform Scripts, click the relevant listener transform script, and select the displayed script. Then navigate to Integrations > Push Connectors, click New, and paste in the script you copied from the listener transform script.