Skip to main content

This content has been archived and is no longer being updated. Links may not function; however, this content may be relevant to outdated versions of the product.

Support Article

Emails not being sent after removing support for TLS 1.0



Emails are not sent post removal of support for TLS 1.0.

Error Messages

** Caught javax.mail.MessagingException: Could not convert socket to TLS

Steps to Reproduce

Not applicable

Root Cause

A defect or configuration issue in the operating environment.
The TLS version in use for email defaulted to whatever the JVM default is in Pega 7.2.1. For Java 1.7, it is TLS 1.0.


To force a different version of TLS, a local change is necessary for SMTP(S) where the UI for the email account is modified to set the Advanced properties.
    1. Open and save the pyOutboundSettings section to the ruleset.
    2. Open the pyInboundSettings section.
    3. Right click the dynamic layout > pyInboundSettings > Advanced. Copy it. 
    4. In the new pyOutboundSettings, paste the copied layout at the bottom. 
    5. Expand the Advanced grid from the newly pasted layout and edit the cell properties. 
    6. Change the page context from .pyReceiverAdvancedProps to .pySenderAdvancedProps. The UI may display an error, but Submit anyway.
    7. Save pyOutboundSettings
    8. Open or refresh the Email Account rule form. The Advanced section displays. Add the Java mail properties in this section:

      Value: TLSV1.2 (or any version as required) 

    Published December 27, 2018 - Updated October 8, 2020

    Was this useful?

    0% found this useful

    Have a question? Get answers now.

    Visit the Collaboration Center to ask questions, engage in discussions, share ideas, and help others.

    Did you find this content helpful?

    Want to help us improve this content?

    We'd prefer it if you saw us at our best.

    Pega Community has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

    Close Deprecation Notice
    Contact us