How to know current Email governor limits? [duplicate]

Question

I am using SingleEmailMessage api for sending emails. I want to know the email limit quota usage, so that I can prevent further exceptions. Is there any way to know the quota usage in apex, so that I can handle exception with ease.

Answer 1

You can use the Limits class to find out how many invocations remain as follows:

Integer remainingInvocations =
    Limits.getLimitEmailInvocations() - Limits.getEmailInvocations();

Answer 2

A strategy to use would be the following (assuming your APEX is sending one (1) email message; adapt code for more than one accordingly. The key is the method Messaging.reserveSingleEmailCapacity(someInteger) that you invoke before you send.

Messaging.SingleEmailMessage email = new Messaging.SingleEmailMessage();
try {
        Messaging.reserveSingleEmailCapacity(1); // SFDC throws exception if no headroom
        email.setToAddresses(...);
        ...
        Messaging.sendEmail(email);
}
catch (HandledException e) {
// do something interesting like set up a retry mechanism for the next day
// by persisting the message to send in some object and then having a daily
// scheduled job resend the message at 0000h
}

There is a related post on this topic by @DougB

UPDATE

Prior to Winter 14, the reserveMassEmailCapacity existed but would throw an unhandled exception, this changed as per the Winter 14 Release Notes page 304

Updated Errors for Email Messaging Methods Errors have changed for the Apex Messaging methods reserveMassEmailCapacity and reserveSingleEmailCapacity, which are used when sending a mass or single email, respectively. If the transaction would cause the organization to exceed its daily email limit, using either of these methods results in a Handled Exception error. (Previously it resulted in a Limit Exception error.) The error that appears is: System.HandledException: The daily limit for the org would be exceeded by this request.