When attempting to deploy profiles, you may encounter the error "Unknown user permission: SendExternalEmailAvailable". What does this mean, and how can you resolve it?


This relates to the "Send through External Email Services" setting in Setup. Go to Setup > Email Administration > Send through External Email Services to see the setting. According to the description of that setting,

"Allow users to send emails through Gmail/Office 365 when composing emails in Lightning Experience. The Send Email through External Email Services user permission is enabled by default on standard profiles."

To resolve this error, manually ensure that your settings match in the source and target orgs.

enter image description here

  • 1
    FYI, the "Unknown user permission" error often happens when the "from" org is a new version than the "to" org during the window when orgs are moving to a newer version. – Keith C Sep 9 '16 at 7:42
  • 1
    and if you don't see the option "Send through External Email Services", you need to set the "Access Level" in "Deliverability" to "All email". – Christophe Vidal Dec 6 '17 at 9:50
  • This actually only seems to fail if the "Deliverability" is not set to "All Email" - I tried deploying even if the settings don't match and it fails in case deliverability is not "System Email", but succeeds if set to "All Email" – sskular Feb 4 '18 at 19:43

Set Email Deliverability to 'All Email':

Email Deliverability Setting

For unknown reason Salesforce automatically creates and removes this permission completely behind the scenes on all profiles based on the value of this setting. This will fail deployments that contain profiles from orgs where this setting is set to 'All Emails' where the target org has this setting set to 'No Access' or 'System Email Only'.

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.