A Mail payload provides information about a Mail server to use, including account information if required. This payload provisions incoming and outgoing email server settings to allow company devices to connect to corporate mail services.
Configuration Settings
- Select Profiles from the left-hand navigation panel and click the Edit (Pencil) icon next to your target profile.
- Navigate to the What tab on the profile configuration screen.
- Click the Restrictions icon to open the security settings menu.
- Select the Accounts option
- Find MAIL
- Select Add New and configure the following settings:
General Settings
| Field | Description |
| Account Type | Select the protocol (e.g. IMAP). |
| Path Prefix | Optional path prefix for IMAP folders on the server. |
| Account Description (*) | A user-visible description of the email account, shown in the Mail and Settings applications. |
| User Display Name | The full user name for the account. This name is shown in sent messages. |
| Email Address (*) | The full email address for the account. If this string isn't present in the payload, the device prompts for it during profile installation. |
Options
- Prevent user from moving messages out of this account
- Prevent Recent Addresses from being synced
- Allow Mail Drop
- Prevent sending mail from apps other than Apple Mail
Incoming Mail (IMAP)
| Field | Description |
| Authentication Type | Select the authentication method (e.g. None). |
| Use SSL | Enable SSL encryption for incoming mail. |
| Hostname (*) | The hostname or IP address of the incoming mail server. |
| Port | If no port number is specified, the default port for a given protocol is used. |
| Username (*) | The username for authentication. If blank and authentication is required, device will prompt for username during profile installation. |
| Password | Password is used only with encrypted profiles. |
| Discard domain suffix if Username is an email address | Trims the domain from the username (e.g. john@example.com becomes john). |
Outgoing Mail
| Field | Description |
| Authentication Type | Select the authentication method (e.g. None). |
| Use SSL | Enable SSL encryption for outgoing mail. |
| Hostname (*) | The hostname or IP address of the outgoing mail server. |
| Port | If no port number is specified, ports 25, 587, and 465 are used, in that order. |
| Username (*) | The username for authentication. If blank and authentication is required, device will prompt for username during profile installation. |
| Password | Password is used only with encrypted profiles. |
| Discard domain suffix if Username is an email address | Trims the domain from the username (e.g. john@example.com becomes john). |
| Outgoing Password Same As Incoming Password | If true, the user is prompted only once for the password, which is used for both outgoing and incoming mail. This setting is only supported by interactive profile installations. Not supported by non-interactive installations (like MDM on iOS). |
Fields marked with (*) are required.