I'm scoping out a project that will involve sending outbound email messages, and I'm a little confused about why one would use a MassEmailMessage instead of multiple SingleEmailMessages.

If you look at the documentation, Singles have far more options available when it comes object types that can be used in the setWhatId methods, especially since they can accept Custom objects. Mass emails have very limited options for the setWhatIds.

SingleEmailMessage: http://www.salesforce.com/us/developer/docs/apexcode/Content/apex_classes_email_outbound_single.htm

MassEmailMessage: http://www.salesforce.com/us/developer/docs/apexcode/Content/apex_classes_email_outbound_mass.htm

Single and Mass emails have separate limits, but they both have the same limit of 1,000 external email addresses per day.

And when it comes to using the Messaging.sendEmail(), you have pass in an array of messages anyway, so why not send in an array of many Singles instead of an array of one Mass?

So what am I missing? What's the advantage of using a MassEmailMessage for sending out a batch of emails when the SingleEmailMessages have more options?


What MassEmailMessage appears to give you is a more optimal coding route if you are focusing on sending to Contacts, Leads or Users relating to either Contract, Case, Opportunity or Product objects.

So if you had 50 such Contacts to email you need only have a single MassEmailMessage instance and set a list of those Id's into it. Instead of creating 50 SingleEmailMessage instances each setup accordingly (you'll have to pull the email addresses yourself) to achieve the same. So there is arguably a marginal heap and statement benefit as well. As you say there are quite a few more features on the SingleEMailMessage, but if you don't need any of those perhaps the MassEmailMessage has a place.

Update: As Mohith has pointed out, you can pass 250 Ids to MassEmailMessage vs 100 emails for the same message, again it depends your objects and features you need. If your scaling above my earlier example of 50 and working with these objects, this is indeed an additional benefit to those I've described above. Though utlimatly its only dictating how many instances of each you pass in the array to the sendEmail, which ultimatly then governs overall what can be sent anwyay.

| improve this answer | |
  • 1
    Is this still current in 2020? I cannot find any documentation on this (250 mass / 100 single mails per invocation)? All I can find regardin email sending is this help.salesforce.com/… and this help.salesforce.com/… but both don't say anything about these limits (only about 5000 total per day) – Christoph Apr 7 at 12:19

setTargetObjectIds method of MassEmailMessage accepts max of 250 Ids and setToAddresses of SingleEmailsMessage accepts 100 email address.This is what i would consider when designing.And also agreed with Andrew on his answer objects we focus matter while selecting

| improve this answer | |
  • Hi Mohit, is the 250 Ids limit on one emailMessage instance? is there a limit on the number of MassEmailMessage instances I can create? – akash Jan 23 '15 at 9:57

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.