Loading

Unsupported X-SFDC Email Headers in Salesforce Inbound Email Services (Email-to-Case, Email-to-Apex)

Publiseringsdato: May 28, 2026
Beskrivelse

What Are X-SFDC Headers?

X-SFDC headers are custom email headers that Salesforce adds to inbound emails in addition to standard headers such as To, From, and Subject. For example, when an email is received by an inbound email service such as Email-to-Case or Email-to-Apex, Salesforce may append headers like X-SFDC-Original-RCPT.

Why X-SFDC Headers Should Not Be Used in Custom Code

These X-SFDC headers are for Salesforce internal use only and are not supported for use with custom code associated with inbound email services. There is no guarantee or contractual commitment on their contents, and they are subject to change without notice.
Relying on undocumented X-SFDC headers in custom Apex code creates a risk of unexpected behavior, broken integrations, or silent failures if Salesforce modifies or removes those headers in a future release.

Løsning

To avoid issues caused by undocumented X-SFDC headers in your custom code for Email-to-Case or Email-to-Apex services, follow these steps:

  1. Audit your custom Apex email handler code. Review any Apex classes used with Email Services for logic that reads or parses X-SFDC headers (for example, code referencing X-SFDC-Original-RCPT or similar header names).
  2. Remove or replace reliance on unsupported headers. Replace any logic that depends on undocumented X-SFDC headers with supported Salesforce APIs or documented header fields.
  3. Use only documented headers. Salesforce will update its documentation to describe any X-SFDC headers it commits to supporting. Only use headers explicitly listed in the official documentation.
  4. Request supported functionality through IdeaExchange. If you require specific header-based behavior that is not currently available, submit a feature request through the Salesforce IdeaExchange.

Note: Salesforce will update documentation to describe supported X-SFDC headers as they are officially committed to. Any headers not listed in that documentation should not be relied on.

Knowledge-artikkelnummer

000390516

 
Laster
Salesforce Help | Article