I have created an email service based on the Salesforce documentation found at the following address:


The only issue is that my class (which clearly impliments the InboundEmailHandler) is not being recognised as a compatible email service class.

My class:

global class processEnquiryEmail implements Messaging.InboundEmailHandler {
 global Messaging.InboundEmailResult handleInboundEmail(Messaging.InboundEmail email, Messaging.InboundEnvelope envelope) { 
   Messaging.InboundEmailResult result = new Messaging.InboundEmailresult();

   Inbound_Email__c ie = new Inbound_Email__c(); 
   ie.From__c = email.fromname; 
   ie.Body__c = email.plainTextBody; 
   ie.Subject__c = email.subject; 
   ie.Email__c = envelope.fromAddress;

   try{insert ie;}
   catch(Exception e){
      system.debug('There was an error processing the email. ' + ie); }   
   return result; 

and I am getting the following error when i try to activate my email service:

The Apex Class selected is not valid. An Apex Class that implements the Messaging.InboundEmailHandler interface must be selected.

Does anyone know why I can not use the above class in my email service? What is making it incompatible?

3 Answers 3


After speaking to Salesforce support I have resolved the issue. Rather than delete the post i will answer it incase anyone has similar issues...

The support consultant literally took a copy of my class, deleted it from the system and reinstated it again. After doing this the class became compatible with the Email Service despite no code changing.

I recommend following the above steps before racking your brains over it as I did. It is obviously just a Salesforce bug...

  • i have a vague genetic memory that if the class is not marked as active, it can't be selected. I seem to recall having to write a testmethod and executing it (probably could use anonymous apex too) to get the class to be acceptable
    – cropredy
    Commented Jan 28, 2015 at 1:56
  • 2
    I actually already had a test method, run with 90% coverage (stupid try-catches) and the apex class was definitely active. This has happened to me in the past but with scheduled apex classes, never with email services.. It is obviously a bug across the board that developers need to be aware of Commented Jan 28, 2015 at 2:14
  • my other vague genetic memory was that I had to create the class using the UI not Eclipse to get it to be accepted ...but this of course was not consistent
    – cropredy
    Commented Jan 28, 2015 at 2:22
  • 2
    I just ran into this. The class is invalid (needs recompilation). If you go to the Apex Class listing page and filter on Is Valid = false, you'll see it listed. 'Compile All' of the classes from that listing page and then the classes should go away in the Is Valid = true filtered list view. Then you can use the class in the Email Service setup. Commented Sep 15, 2016 at 18:51
  • Had the same problem. In my case, I just made a change to the class so that it pushed, then it worked :|.
    – mikeyq6
    Commented Jul 27, 2021 at 16:20

This error indicates that the packaged Apex Class has not yet been compiled. Typically, Apex Classes are compiled when saved. However, Apex Classes associated with Managed Packages cannot be saved so they rely on the runtime engine to compile them, either when they are first used or at some point automatically after they are installed.

If you encounter this error, please follow the steps below to manually compile that Apex Class:

  1. Navigate to Setup > Develop > Apex Classes.
  2. On the Top Left, click the link labeled “Compile all classes”.
  3. Once Compilation is complete, reattempt setting up the Email Service

Thanks I hope this will helps you.

Edit: the Known Issue writeup is here, and hopefully someone from Known Issues team will augment that writeup to include this workaround.


I faced the same issue with Email Services (with a bonus of Sandbox vs Production problem).

I created a class in the sandbox that implemented the Messaging.InboundEmailHandler interface which worked fine in the sandbox but I got the same error in production, after reading the solution support gave to David I tried something that shouldn't work but it did.

I fixed the error (or find a workaround for the bug) by compiling the class in production from the IDE (I'm using MavensMate) and then I was able to create the Email Service without any problem.

Note: Just in case you can't wait for support to get back to you.

You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged .