{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":39780,"path":"platform-administration/t_CreateAnEmailFilter.md","title":"Create an email filter","bundle":null,"doc_type":null,"release":"australia","body":"\n# Create an email filter\n\nYou can create email filters to apply a custom action script or filter actions when email matches your filter's conditions.\n\n## Before you begin\n\nRole required: admin\n\n## Procedure\n\n1.  Navigate to **All** > **System Mailboxes** > **Administration** > **Filters**.\n\n2.  Click **New**.\n\n3.  On the form, fill in the fields.\n\n    |Field|Description|\n    |-----|-----------|\n    |Name|Name of the email filter.|\n    |Application|Application scope of the email filter.|\n    |Order|Priority that the email filter takes over other filters for the same table. To give the filter higher priority over other filters, enter a lower number.|\n    |Active|Option to activate the email filter.|\n    |Short description|Description of what the filter does.|\n    |Conditions|Conditions to define which emails to filter.|\n    |Condition script|Script to define which emails to filter. Use this script to access other tables, variables, or methods. For example, the condition script for the Ignore VCAL filter looks for the results of the EmailUtils script include, which detects vCalendar attachments.|\n    |Action script|Script to define additional behavior to be performed when the filter condition evaluates to true. This might include an email action not included in the default filter actions. In the base system, the action script is used to produce the error string that is published to the email log \\(**System Logs** > **Email**\\).|\n\n4.  Right-click in the header bar and select **Save** from the context menu.\n\n    The Filter Actions related list appears.\n\n5.  Click **New** in the related list.\n\n6.  Select how the system should react when the conditions of this filter evaluate to true.\n\n    The two choices in the base system are: Mark as Ignored and Move to Junk. You can use the Action script to perform additional email tasks.\n\n    **Note:** Before creating additional email actions with a script, see [Inbound Email Actions](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-administration/c_InboundEmailActions.md). Like business rules, inbound email actions use both conditions and scripts and can provide a number of useful actions on emails the instance receives.\n\n\n**Parent Topic:**[Email filters](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-administration/c_EmailFilters.md)\n\n"}}