# Message Filters · Email · Admin Portal

Configure filters for incoming email and route the resulting tickets to a queue or ticket type. Build a condition tree using AND to require all conditions or OR to accept at least one. Conditions can inspect the sender (From), subject, body, recipient and received mailbox; the examples combine sender and subject conditions to route messages to the Support queue.

Canonical: https://docs.mintsd.com/docs/mint-service-desk/admin-portal-message-filters
Language: en-GB
Revision: 2a2d39f1e31deba465d9905cd685a5a3416966a588eb6151bba19ba5bc3c7cc9

<a id="element-01a1452e-1539-76bd-8582-a9c89e2ad3ec"></a>

Create filters for incoming email to assign the resulting tickets to a queue or ticket type when the configured conditions match.

<a id="element-01a1452e-153a-7c02-9a1d-408a5d7cc959"></a>

![Create filters for incoming email to assign the resulting tickets to a queue or ticket type when the configured conditions match.](https://docs.mintsd.com/api/reader/assets/assets/images/image474.png?v=fa7578fd512285fea35cbb71df1de53d3f1c62ad57bb6361d71657556b4aa409)

<a id="element-01a1452e-153a-7604-b858-d6be417c7d91"></a>

<a id="element-01a1452e-153b-7991-83db-9e3e8dc45cb5"></a>

## Filter conditions

To create a new message filter, click the ![Add](https://docs.mintsd.com/api/reader/assets/assets/images/image3.png?v=50654a0321a77a3b2271140f1b6a5080d18fbef92f3639b9b83ad57f0fd5735d#element-01a1452e-153a-7604-b858-d6be417c7d91) button located on
the right side, next to the search field. You will be moved to the
‘Create filter’ form.

<a id="element-01a1452e-153b-7790-a601-d0532e2432c5"></a>

![To create a new message filter, click the button located on the right side, next to the search field. You will be moved to the ‘Create filter’ form.](https://docs.mintsd.com/api/reader/assets/assets/images/image1169.png?v=e71efd5dba8483ccc3182317ebd88b77ea6f3c8e727ed0933f0c4f4325f54c09)

<a id="element-01a1452e-153b-7ed7-89fb-63d6d8eb3673"></a>

<a id="element-01a1452e-153c-71ed-8199-af12d20126ac"></a>

First, click on ![Add](https://docs.mintsd.com/api/reader/assets/assets/images/image481.JPG?v=8a3f233f904783ff39eb2aa0e274c6c68691b4a3991c043a885cba758cc2555b#element-01a1452e-153b-7ed7-89fb-63d6d8eb3673) button located below “Condition tree”.

<a id="element-01a1452e-153c-735f-b6e5-e61ac540aac7"></a>

![Message Filters: First, click on button located below “Condition tree”.](https://docs.mintsd.com/api/reader/assets/assets/images/image476.png?v=be77df348fd222e851343d590928de8363f46e373167d79d47d495edf06db157)

<a id="element-01a1452e-153d-700e-ae00-32d87d692408"></a>

Select the type of condition in the window.

<a id="element-01a1452e-153d-7221-af0a-61d219625085"></a>

![Message Filters: Select the type of condition in the window.](https://docs.mintsd.com/api/reader/assets/assets/images/image478.png?v=c1c72666deda6619b477d7eda6091a0a939a0b1d978ef7c4851b2d992ae28f24)

<a id="element-01a1452e-153d-7a5b-9372-357bcce0c52f"></a>

The first condition must be a logical operator: AND or OR. Select it and click “Save”.

<a id="element-01a1452e-153e-75df-af07-5292437422a5"></a>

![Message Filters: The first condition must be a logical operator: AND or OR. Select it and click “Save”.](https://docs.mintsd.com/api/reader/assets/assets/images/image1162.png?v=599349fe21b69f1040f60608a9f560275a139e0d16bec98971efb895fb27110c)

<a id="element-01a1452e-153e-7961-bd64-a5199a177aca"></a>

<a id="element-01a1452e-153f-7b3c-8626-daa73ba46fb0"></a>

Now click on ![Add](https://docs.mintsd.com/api/reader/assets/assets/images/image481.JPG?v=8a3f233f904783ff39eb2aa0e274c6c68691b4a3991c043a885cba758cc2555b#element-01a1452e-153e-7961-bd64-a5199a177aca) button once again and select another condition. Let’s select
“Message filters” and save.

<a id="element-01a1452e-153f-75ab-8587-32641192c255"></a>

![Now click on button once again and select another condition. Let’s select “Message filters” and save.](https://docs.mintsd.com/api/reader/assets/assets/images/image1163.png?v=5b851054de1ae787080d26872b188965c9b2c446ae781a4a06a21c11e17b3737)

<a id="element-01a1452e-1540-72d2-8c15-50751631c73b"></a>

The Type, Operation and Value fields appear.

<a id="element-01a1452e-1540-79bd-b88b-b5df74866402"></a>

![Message Filters: The Type, Operation and Value fields appear.](https://docs.mintsd.com/api/reader/assets/assets/images/image1164.png?v=007a6bed9248b5f1752c1bcf742e3866c3020e174d92b81578b791c8d1a7661d)

<a id="element-01a1452e-1541-7948-a7d3-3ad56da0e28b"></a>

Select “Type” - it is the part of the email you want to filter. You can choose between ‘Body’,
‘Subject’, From’, ‘To’ and ‘Received mailbox account’.

<a id="element-01a1452e-1541-70ab-90dd-6bd266d0b2a9"></a>

![Select “Type” - it is the part of the email you want to filter. You can choose between ‘Body’, ‘Subject’, From’, ‘To’ and ‘Received mailbox account’.](https://docs.mintsd.com/api/reader/assets/assets/images/image1165.png?v=4ef4dd04187e235d2b997a850199741e15df45e850adb6904a3ce6b5dc0ff57a)

<a id="element-01a1452e-1542-7d4b-ac49-37015b30c66c"></a>

Choose an ‘Operation’: “Contains”, “StartsWith”, “EndsWith”, “IsEqual” or “MatchPattern”.

<a id="element-01a1452e-1542-7df1-80c1-d55738c3ddda"></a>

![Message Filters: Choose an ‘Operation’: “Contains”, “StartsWith”, “EndsWith”, “IsEqual” or “MatchPattern”.](https://docs.mintsd.com/api/reader/assets/assets/images/image479.png?v=05554ef2dab2807de7d114363fe4f81a14f4bfbea2e0d5468b35dec15fd84399)

<a id="element-01a1452e-1543-7fa5-9c3f-86f1ab9dbd01"></a>

In “Value”, enter the text or pattern to match.

<a id="element-01a1452e-1543-7631-bde7-5d2e40bb1bb1"></a>

![Message Filters: In “Value”, enter the text or pattern to match.](https://docs.mintsd.com/api/reader/assets/assets/images/image480.png?v=0041f979911a9e77fee75cd0cef14a8125845f6cf59bab82976f96940a125216)

<a id="element-01a1452e-1544-7f35-91d4-a819ab5d7f14"></a>

For each of the criteria, you can select the ‘Match case’ check-box. It
is related to the ‘Stop after match’ option mentioned before.

<a id="element-01a1452e-1544-7123-a1c0-b3401cb93032"></a>

<a id="element-01a1452e-1544-75ec-9148-f97963046a12"></a>

<a id="element-01a1452e-1545-77cc-a9cb-81c5c76347e4"></a>

If you want to add additional criteria you can use the ![Add](https://docs.mintsd.com/api/reader/assets/assets/images/image481.JPG?v=8a3f233f904783ff39eb2aa0e274c6c68691b4a3991c043a885cba758cc2555b#element-01a1452e-1544-7123-a1c0-b3401cb93032) button again. If you want to delete
any condition, just use the ![Delete](https://docs.mintsd.com/api/reader/assets/assets/images/image228.png?v=b49c174f13ec30cdd023f322f43c60d2f2e16a16d3f207ccbfa119b0906a0fe2#element-01a1452e-1544-75ec-9148-f97963046a12) button.

<a id="element-01a1452e-1545-772a-9efe-8ef388f828e0"></a>

## Actions after a match

The panel below defines what happens to the ticket after a match.

<a id="element-01a1452e-1545-798b-96fa-54b13ceeb9cb"></a>

![Message Filters: The panel below defines what happens to the ticket after a match.](https://docs.mintsd.com/api/reader/assets/assets/images/image923.png?v=693e7eae4a50ea8aa0036e1b1336eaee02076aaf25e2a7ff03bf0fcbf2f83489)

<a id="element-01a1452e-1546-7210-9585-c22142cc946b"></a>

Right here you need to name your filter (‘Name’). You can select the ‘Queue’
in which a Ticket will be created (from the email message sent). You can
also specify the ‘Ticket type’ which will be added to the created Ticket
(from the email message). Other fields that can be configured are: ‘Status’, ‘Assignee’,
‘Priority’, ‘Service’. Configuring these fields will set the wanted fields after matching.

<a id="element-01a1452e-1547-7840-9345-e552eb22c6fd"></a>

Next, you can select the check-box ‘Stop after match’. Check it if you
want to match one (or more) of the criteria you are creating (those with
additional ‘Match case’ check-box selected by you). If you want to match
all the criteria, leave this option unchecked.

<a id="element-01a1452e-1547-798d-83c8-e1b7c0b6964a"></a>

At the bottom there is ‘Active’ checkbox, where you can decide, if your filter should be active or not.
You can always change it by edit message filter.

<a id="element-01a1452e-1548-73b8-943d-e528c24841d1"></a>

<a id="element-01a1452e-1548-7b28-a00f-a5f4aca97352"></a>

Once you finish click the ![Create](https://docs.mintsd.com/api/reader/assets/assets/images/image58.png?v=3659f4ed6ae2729e35fe5eb8832cf827f8c264181610e981304daec839c30f99#element-01a1452e-1548-73b8-943d-e528c24841d1) button in order to save your new
message filter.

<a id="element-01a1452e-154a-7a51-a58b-9afad048fbd4"></a>

## Examples of combined conditions

For example, route messages from **customer1@mintsd.com** AND with the subject **Support** to the **Support** queue.

<a id="element-01a1452e-154a-736c-b934-32d693c33983"></a>

Configure both conditions under AND:

<a id="element-01a1452e-154b-7019-a3e4-06db110834d8"></a>

![Message Filters: Configure both conditions under AND:](https://docs.mintsd.com/api/reader/assets/assets/images/image1166.png?v=d339f9cf0699f8932c2a703fff4612ff7568009a04028cb2aec6f7c67d2c24a4)

<a id="element-01a1452e-154c-7512-aa90-e57646e239f9"></a>

This means that an incoming email must meet both conditions to be redirected to the **Support** queue.

<a id="element-01a1452e-154e-7da7-8e9b-03341b0c6da3"></a>

To route messages from **customer1@mintsd.com** OR with the subject **Support** to the **Support** queue, use this configuration:

<a id="element-01a1452e-154e-7631-9a51-507618c2d999"></a>

Configure the conditions under OR:

<a id="element-01a1452e-154f-7f61-98d1-148f2930b494"></a>

![Message Filters: Configure the conditions under OR:](https://docs.mintsd.com/api/reader/assets/assets/images/image1167.png?v=0d57dc5644aa1f53aa044a8780018cd00a5f29d36db093d0da6d8969e90afbb3)

<a id="element-01a1452e-1550-79fc-843e-52289d82cd10"></a>

This means that all emails meeting at least one of the above conditions will be redirected to the **Support** queue.

<a id="element-01a1452e-1552-75ed-8c1d-0a940f114c1f"></a>

For a combined rule, accept messages from **customer1@mintsd.com** or **customer2@mintsd.com**, but require **Support** in both the subject and body. Send matching tickets to the **Support** queue.

<a id="element-01a1452e-1552-7b21-8733-e215d3412f15"></a>

To achieve this, we create a more complex configuration as shown below:

<a id="element-01a1452e-1553-768f-8288-74859d4dca4a"></a>

![Message Filters: To achieve this, we create a more complex configuration as shown below:](https://docs.mintsd.com/api/reader/assets/assets/images/image1168.png?v=23e0bc149384602968be9acf1af81b68aaa0178e0dabfbbc8946680803764339)

<a id="element-01a1452e-1554-7f86-ba70-9273091ebb38"></a>

Combine nested logical operators to express more complex matching rules.

<a id="element-01a1452e-1555-7e3b-9687-5d97d8b073fc"></a>

<a id="element-01a1452e-1555-70f6-9923-50cce136b2cd"></a>

<a id="element-01a1452e-1555-7578-a11c-1443d1df82e7"></a>

## Editing a filter

Remember that after creating a new message filter you can always either
change anything inside (![Edit](https://docs.mintsd.com/api/reader/assets/assets/images/image89.png?v=702adcf46ea452d46f158b0c91e923f5b40ae6f37d95ca5764e20654a2855c4c#element-01a1452e-1555-7e3b-9687-5d97d8b073fc) button) or even delete it from the
system (![Delete](https://docs.mintsd.com/api/reader/assets/assets/images/image202.png?v=1ae492635a6fc6619d5b242c62eff118e37d8d48440153360fc4ec4913f5ed3a#element-01a1452e-1555-70f6-9923-50cce136b2cd) button). To make changes to a saved filter in the Condition tree section, you need
to click the Edit mode toggle:

<a id="element-01a1452e-1556-7b02-bc89-544aa07fa979"></a>

![Remember that after creating a new message filter you can always either change anything inside (button) or even delete it from the system (button). To make changes to a saved filter in the Condition tree section, you need to click the Edit mode toggle:](https://docs.mintsd.com/api/reader/assets/assets/images/image1170.png?v=abbed64ef279f3fa582fbf3ac2f52433802bb8254462050c9ce1471275241756)

<a id="element-01a1452e-1556-785b-8027-b50d8f757577"></a>

Confirm the edit in the window shown below.

<a id="element-01a1452e-1557-7689-95a1-de82981444d2"></a>

![Message Filters: Confirm the edit in the window shown below.](https://docs.mintsd.com/api/reader/assets/assets/images/image1171.png?v=3d499f23c0ab31af2d938e00bf40caf7695178b0e45c9bb6de7d426458fc9fd8)

