The `notification.exe` utility is used for configuring automatic sending of e-mail notices on system events.
## Location `%plesk_cli%`
## Usage
notification.exe <command>
<option 1> <param> [<option 2> <param>] ... [<option N> <param>]
## Example The following command configures Plesk to notify the server administrator when a new customer account is created:
plesk bin notification.exe --update -code client_creation -send2admin true
## Commands

Command

Parameter

Description

Example

--update or -u

-code <event code>

Updates automatic notification settings for a specific event. The available codes are provided in the Supported notification codes table below.

To configure Plesk to notify the server administrator when a new customer account is created:

plesk bin notification.exe --update -code client_creation -send2admin true

--expiration

<number of days>

By default, Plesk is configured to send subscription expiration warnings 10 days in advance. You can adjust this setting with the --expiration command.

To set the number of days for sending the expiration warnings 5 days in advance:

plesk bin notification.exe --expiration 5

--help or -h

Displays help on the use of the utility.

To view a help page for the utility:

plesk bin notification.exe --help

##  Options

Option

Parameter

Description

Example

-code

<number>

Specifies the code of a system event. The available codes are provided in the Supported notification codes table below.

To configure Plesk to notify the server administrator when a new customer account is created:

plesk bin notification.exe --update -code client_creation -send2admin true

-send2admin

true|false

Enables sending of notices about the specified event to the server administrator.

-send2reseller

true|false

Enables sending of notices about the specified event to the appropriate reseller accounts.

To configure Plesk to notify the resellers when new customer accounts are created:

plesk bin notification.exe --update -code client_creation -send2reseller true

-send2client

true|false

Enables sending of notices about the specified event to the appropriate customer accounts.

To configure Plesk to notify customers about creation of their accounts:

plesk bin notification.exe --update -code client_creation -send2client true

-send2email

true|false

Enables sending of notices about the specified event to the specified e-mail address.

To configure Plesk to send an e-mail notice to postmaster@example.com when new customer accounts are created:

plesk bin notification.exe --update -code client_creation -send2email true -email postmaster@example.com

-email

<string>

Specifies the e-mail address to which notices should be sent.

-subj

<string>

Specifies the e-mail message subject for a notice.

The following example customizes the properties of the notice sent on customer account creation:

plesk bin notification.exe --update -code client_creation -subj "Your account credentials" -text "Dear <client_contact_name>, to log in to your Control Panel, go to https://<hostname>:8443. Your username is <client_login> and the password is <password>"

-text

<text>

The notice text that should be sent.

In the text, you can use variables that will be substituted with the appropriate data.

For a list of supported variables, refer to Plesk Administrator’s Guide, chapter Configuring the Server, section Configuring E-mail Notification System.

## Supported notification codes
| Code | Action | |----|----| | `client_creation` | Customer account creation | | `domain_creation` | Site creation | | `domain_limits_exceed` | Resource usage limits exceeded by subscription | | `domain_expiration` | Subscription expiration | | `domain_exp_warning` | Subscription expiration warning | | `reseller_creation` | Reseller account creation | | `reseller_limits_exceed` | Resource usage limits exceeded by a reseller account | | `domain_blocked` | Subscription suspended due to resource overuse | | `reseller_blocked` | Reseller account suspended due to resource overuse | | `reseller_overuse_block` | Reseller’s resource usage limits reached by reseller’s subscriptions due to overselling | | `admin_outgoing_mail_exceeded_limits` | Attempts to exceed outgoing limits for domains, mailboxes and subscriptions | | `admin_pum_updates` | System Updates: notifications about new updates | | `subscription_cgroups_limits_exceed` | The resource usage threshold has been exceeded | | `admin_postponed_feedback` | Feedback reminder |