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

Get Email Header action

Access an email header value as a data pill in a flow.

Roles and availability

Available as a Workflow Studio core action. Process analysts use the flow_designer role to add an action to a flow and define configuration details.

Fields

FieldDescription
Email RecordRecord from the Email \[sys\_email\] table.
Target Header

Header from the email record. Upon completion of the action, the header value is added as a data pill in the flow.Note: If multiple headers have the same name, the action gets the value of the first header that appears.

This input requires a string value matching an email header name. ServiceNow provides several dedicated email headers.

  • X-ServiceNow-Source
  • X-ServiceNow-SysEmail-Version

Example

In the following example, a process owner adds the Get Email Header action under an inbound email trigger. In the Email Record field, the user selects to get an email header from the email that triggered the flow. In the Target Header field, the user selects to get the X-ServiceNow-Source header from the email.

Image omitted: get-email-header-example-configuration.png
Get Email Header action example

Testing the flow with a sample email record produces the header value as a data pill.

Image omitted: get-email-header-example-execution-details.png
Sample header value with a unique notification ID.

Parent Topic:Workflow Studio actions