# SNI Email Settings

SSL Certificates / SNI Email Settings

## Disable SNI mail services for domain

 - [GET /SSL/disable_mail_sni](https://api.docs.cpanel.net/specifications/cpanel.openapi/sni-email-settings/disable_mail_sni.md): This function disables SNI mail services on the specified domains.

Note:

  Mail SNI is always enabled.

  * After you change the SNI status, you must run UAPI's rebuild_mail_sni_config function.
  * Functions that enable Mail SNI succeed with a warning that Mail SNI is always enabled.
  * Functions that disable Mail SNI fail and make no changes.

## Enable SNI mail services for domain

 - [GET /SSL/enable_mail_sni](https://api.docs.cpanel.net/specifications/cpanel.openapi/sni-email-settings/enable_mail_sni.md): This function enables SNI mail services on the specified domains.

Warning:

Mail SNI is always enabled.
* Mail SNI is not compatible with Webmail and will not function for any Webmail connection. Webmail connections use the cPanel service SSL certificate.
* Functions that enable Mail SNI succeed with a warning that Mail SNI is always enabled.
* Functions that disable Mail SNI fail and make no changes.

Important:

  When you disable the Calendars and Contacts, Mail Receive, Web Disk, Webmail, and Web Server roles, the system disables this function.

## Return whether mail SNI is enabled

 - [GET /SSL/is_mail_sni_supported](https://api.docs.cpanel.net/specifications/cpanel.openapi/sni-email-settings/is_mail_sni_supported.md): This function checks whether the sslinstall feature is enabled.

Warning:

Mail SNI is always enabled.
* Mail SNI is not compatible with Webmail and will not function for any Webmail connection. Webmail connections use the cPanel service SSL certificate.
* Functions that enable Mail SNI succeed with a warning that Mail SNI is always enabled.
* Functions that disable Mail SNI will fail and make no changes.

Important:

When you disable the Calendars and Contacts, Receive Mail, Web Disk, Webmail, and Web Server roles, the system disables this function.

## Return whether Apache web server supports mail SNI

 - [GET /SSL/is_sni_supported](https://api.docs.cpanel.net/specifications/cpanel.openapi/sni-email-settings/is_sni_supported.md): This function checks whether the Apache web server supports SNI.

Important:

When you disable the Calendars and Contacts, Receive Mail, Web Disk, Webmail, and Web Server roles, the system disables this function.

## Return status of domain's SNI mail services

 - [GET /SSL/mail_sni_status](https://api.docs.cpanel.net/specifications/cpanel.openapi/sni-email-settings/mail_sni_status.md): This function retrieves the status of the domain's SNI mail services.

Warning:

Mail SNI is not compatible with Webmail and will not function for any Webmail connection. Webmail connections use the cPanel service SSL certificate.

Note:

Mail SNI is always enabled.
* Functions that enable Mail SNI succeed with a warning that Mail SNI is always enabled.
* Functions that disable Mail SNI fail and make no changes.

## Start SNI configuration files rebuild

 - [GET /SSL/rebuild_mail_sni_config](https://api.docs.cpanel.net/specifications/cpanel.openapi/sni-email-settings/rebuild_mail_sni_config.md): This function rebuilds the SNI configuration files.

Note:

* You must run this function after you change the SNI status through the UAPI's enable_mail_sni or disable_mail_sni functions.
* Mail SNI is always enabled.
  * Functions that enable Mail SNI succeed with a warning that Mail SNI is always enabled. Functions that disable Mail SNI fail and make no changes.
  * Functions that disable Mail SNI will fail and make no changes.

Important:

 When you disable the _Calendars and Contacts_, _Receive Mail_, _Web Disk_, _Webmail_, and  _Web Server_ roles, the system disables this function.