Managing Mail on Domain Level

Operator: <mail>

XML Schema: mail_input.xsd, mail_output.xsd, plesk_mailname.xsd

Plesk version: Plesk 7.5.4 for UNIX and later | Plesk 8.1 for Windows and later

API RPC version: 1.3.5.0 and higher

Plesk user: Plesk Administrator, Plesk client

Description

The mail operator allows performing operations on mail service and mail accounts on a particular domain.

The mail service settings specify whether the Webmail application is turned on for a particular domain. These settings also specify the mail service behaviour when an incoming message is addressed to a non-existent user.

Mail user is the less privileged Plesk user. Creating Plesk mail user is equivalent to creating a special mail account on the specified domain. This operation is allowed to Plesk Administrator and Plesk client.

Mail account presents a collection of settings and lists of various objects. A mail account is created on a certain domain and remains associated with this domain during its lifetime. All objects created within the mail account (autoresponders, redirects, files, etc.) share the disk space of the domain that owns this mail account.

Mail accounts are uniquely identified by name/ID of the parent domain and by mail user name.

Mail user settings specify the following:

• Mail name and password, mail aliases
• Mail user access to his mail account through Plesk GUI
• Mail box settings
• Mail user permissions
• Antivirus protection
• Mail group members (if a mail account is used as a mail group)
• Groups in which a mail account has membership
• Files to store in the repository
• Automatic response messages
• Mail addresses to which all incoming correspondence will be redirected automatically

For more details, refer to the Mail Service Settings and Mail User Account Settings sections.

Supported operations

• CREATE creates a mail account on a specified domain and sets a collection of settings for it
• UPDATE serves to update mail account settings. It is specially designed to operate lists of mail group members, repository files, and automatic reply messages set for the mail account
• GET_INFO serves to retrieve various information about the specified mail accounts from Plesk database
• REMOVE removes the specified mail account and all its settings from Plesk database
• ENABLE turns on the mail service on the specified domain
• DISABLE turns off the mail service on the specified domain
• SET_PREFS sets mail service preferences for the specified domains
• GET_PREFS gets mail service preferences set for the specified domains
• RENAME renames the specified mail box