Dynamic system settings for email integrations
Pega Platform provides dynamic system settings that you can use to modify email processing in your system. For example, you can limit the size of an email message that your application accepts, or allow text attachments in the email body.
For more information about updating dynamic system settings, see Editing a dynamic system setting.
Inbound email settings
The following table provides the dynamic system settings that you can configure for your inbound email service:| Owning ruleset | Name | Purpose | Value type | Default value |
| Pega-Engine | prconfig/services/emailMaxSize/default | Limits the maximum size of an email message. You can use this
setting to override the value of the Maximum email size
(KB) field on the Process tab
of the email listener form. | Integer (kilobytes) | -1 (No limit) |
| Pega-Engine | prconfig/initServices/initEmail/default | Controls whether the system initializes the email service at
startup. In a multinode system, you can use this setting to control
whether the email service is available on individual
nodes. | Boolean | true |
| Pega-IntegrationEngine | email/exceptionLatency | Controls how long the email listener waits before it
automatically retries after encountering an error. You can use this
setting to define a fixed sleep interval for the listener before it
retries after an error or exception occurs in the inbound email
processing. | Integer (seconds) | 5 |
| Pega-IntegrationEngine | email/initialLatencyTime | Specifies the delay for the startup of the email listener. You
can use this setting to define a cumulative sleep interval for the
listener before it retries after an error or exception occurs in the
inbound email processing. Multiplication of the value of this
setting by the number of retries determines the blackout period
after an exception occurs. | Integer (seconds) | 5 |
| Pega-IntegrationEngine | email/retryInterval | Specifies the amount of time that passes before the email
listener attempts to reprocess messages. | Integer (minutes) | 120 |
| Pega-IntegrationEngine | email/maxRetry | Specifies the maximum number of retries after a messaging error
occurs. | Integer | 3 |
| Pega-IntegrationEngine | email/enableAttachmentNamesInEmailBody | Controls whether the system enables attachment names in body data mapping. | Boolean | false |
| Pega-IntSvcs | email/copyBodyNoContent | Specifies whether to copy the email subject into the body if the email has no content. | Boolean | false |
| Pega-IntegrationEngine | Email/AutoReplySubject | Specifies the patterns for which the email listener searches in the Auto-Submitted header of the email subjects, in order to detect an autoreply message. | String | Automatic reply,Auto:,Auto Response,Out of Office |
| Pega-IntegrationEngine | Email_throttling_pattern_regex | Specifies the regular expression pattern that evaluates whether
an error message indicates throttling. | String |
|
Outbound email settings
The following table provides the dynamic system settings that you can configure for your outbound email service:| Owning ruleset | Name | Purpose | Value type | Default value |
| Pega-IntSvcs | email/timeout | Controls the connection and read timeouts for the sender and
receiver. Returns an exception if the server does not
respond. | Integer (milliseconds) | 60000 |
| Pega-IntSvcs | email/writeTimeout | Controls the write timeout for the sender and receiver. Returns
an exception if the server does not respond. | Integer (milliseconds) | 50000 |
| Pega-IntSvcs | email/fetchsize | Controls the fetch size if the IMAP partial-fetch feature is
enabled. | Integer (bytes) | 1000000 (1 MB) |
| Pega-IntSvcs | email/partialfetch | Controls whether to use the IMAP partial-fetch feature. Resetting
this value forces the listener to read the entire message at once,
which might lead to potential memory problems with large
emails. | Boolean | true |
| Pega-IntSvcs | email/AddLegacyHeaders | Controls whether to append the old email headers to the new headers. | Boolean | false |
| Pega-IntSvcs | email/blockResponse | Controls whether the email listener sends a response after it
receives an email. If true, the listener
blocks all responses. | Boolean | false |
| Pega-IntSvcs | email/enableTextAttachmentInEmailBody | Controls whether text attachments can be embedded in the email body. | Boolean | false |
| Pega-IntSvcs | email/DisableSecuritySTARTTLS | Controls whether STARTTLS is disabled for inbound and outbound
email connections. | Boolean | false |
| Pega-IntSvcs | FailOnAddressException | Controls whether message processing failures are detected. If
true, ignores processing failures that
are related to the message headers. | Boolean | false |
| Pega-IntegrationEngine | javamail/NoAuthMechanismsRetry | Helps resolve issues with email API upgrades. If
true, reinitiates the connection by
reverting to a non-authenticated SMTP mode session. | Boolean | false |
Previous topic Ensuring messages are processed before switching your email protocol to Microsoft Graph Next topic Correspondence rules and email