Email Routing Rules

Email Routing Rules are the heart of Postmaster. They define the destination record and content to be created from an inbound email. Rules can be created on any table in your ServiceNow instance, including global, custom, and scoped tables.

Email Routing Rule

• Destination table: Table where the resulting record will be created

• Email subject to: Field on the destination table where the email subject should be placed

• Email body to: Field on the destination table where the email body should be placed

• Template: Optional record template to apply to the created record

• Error event: If an error occurs during email receipt & processing, an event can be generated to trigger a notification or other activity in ServiceNow so that administrators are made aware of the issue. Event parameters:

  • record/current: Email GlideRecord

  • parm1: Postmaster rule name

  • parm2: Error generated

• Auto-map fields from email: When enabled, Postmaster will attempt to map fields in the body of the email to fields on the created record

Field auto-mapping requires formatting of field_name:Field Value in the body of the email, where field_name is the internal value of the field name and Field Value is the display value for the field value. For catalog variables, the field name should be prefixed with 'variables.' One field_name:Field Value pair can exist per line in the email.

When necessary, Postmaster will attempt a rigorous search of both internal and display values for both field names and field values, as well as searching for catalog variables without the appropriate prefix.

Examples include:

• assignment_group:Database San Diego

• variables.disk_capacity:64GB

• Apply record script: When enabled, you may use server-script to manipulate the target record, adding or updating field values as-needed.

• Apply cart/item script: (Catalog only) When enabled, you may use the CartJS API to manipulate the catalog cart prior to order submission

• Email condition: Email conditions under which to trigger this rule

In email conditions, the Recipient, Subject, and Body fields of the email will always be compared using all lowercase. All other fields are case-sensitive.