# Mail server connection

## Mail server connection

<img src="/files/XZICDbnJaS3RdFy2JZOT" alt="Mail Server Connection" data-size="line">

A Mail Server connection is a connection to a mail server that can be reused from actions like the [Mail](/data-shaper-1.21/knowing-the-data-shaper-designer/workflows/actions/mail.md) action. Support for other e-mail related actions and transforms will be added in a later release.

### Related Plugins

[Mail](/data-shaper-1.21/knowing-the-data-shaper-designer/workflows/actions/mail.md) action

### Options

| Option                     | Description                                                                                                                         |
| -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| Connection name            | The name to use for this mail server connection                                                                                     |
| Connection protocol        | The connection protocol to use for this connection. Supported options are SMTP, IMAP, POP, MBOX (Only SMTP is currently supported). |
| Server host                | The mail server hostname to use for this connection                                                                                 |
| Server port                | The mail server port to use for this connection                                                                                     |
| Use authentication?        | Use authentication with this connection?                                                                                            |
| User XOAuth2?              | Use XOAuth2 authentication for this mail server connection?                                                                         |
| Username                   | The username to use for this connection                                                                                             |
| Password                   | The password to use for this connection                                                                                             |
| Use secure authentication? | Use secure authentication for this connection?                                                                                      |
| Secure authentication type | The secure authentication type to use for this connection. Supported options are SSL, TLS, TLS1.2                                   |
| Check server identity?     | Check the server identity?                                                                                                          |
| Trusted hosts              | A list of trusted hosts separated by a space, for example: "host1 host2 host3"                                                      |
| Use proxy?                 | Use a proxy server with this mail server connection?                                                                                |
| Proxy username             | The proxy username to use for this connection                                                                                       |
| Proxy password             | The proxy password to use for this connection                                                                                       |

### Samples

None


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.primeur.com/data-shaper-1.21/knowing-the-data-shaper-designer/index-2/mail-server-connection.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.