specify option to limit notifications

[ci skip]
more concise parameter names

[ci skip]
Merge pull request #2102 from opf/feature/specify_optional_mail_notification

[API] Specify optional mail notification