Emma support

MyEmma EMMA FOR SALESFORCE · GUIDE

Maintenance codes.

Find the message. Understand the next step.
Search the codes and messages shown on the Maintenance screen.

Product guideFor Salesforce administrators

This page contains all the codes and messages you may see on the Maintenance screen in Salesforce.

EM4SF_VALIDATE

What this means: Emma could not validate a member or account action from Salesforce.

Common causes: Invalid email; Emma rejected the request; connected Emma user lacks access.

What to do: Confirm email and required fields, check the Emma connection, then retry. Guide: Audience Members.

EM4SF_UPDATE_EMAIL_OPT_OUT

What this means: Updating the Salesforce email opt-out or opt-in field on Contact or Lead failed.

Common causes: Validation rules; missing field access on HasOptedOutOfEmail; triggers blocking save.

What to do: Try saving the Contact or Lead manually to see validation errors, then fix and retry. Guide: Audience Members.

EM4SF_UPDATE_CONTACT_LEAD

What this means: Updating Contact or Lead fields while importing Emma audience details failed.

Common causes: Validation rules; picklist mismatches; wrong field types; bad Salesforce Id in Emma custom fields.

What to do: Read the Maintenance message. Fix the Salesforce save error, then re-run sync or import. Guide: Creating Records.

EM4SF_UNSUPPORTED_OBJECT

What this means: A field mapping uses a Salesforce object or relationship Emma does not support.

Common causes: Unsupported parent object; invalid relationship path.

What to do: Remove or change the unsupported mapping in Field Mappings. Guide: Field Mappings.

EM4SF_TOO_MANY_SCHEDULES

What this means: Import Wizard could not create a Salesforce scheduled job for the run-as user.

Common causes: User already has too many scheduled jobs.

What to do: Remove unused scheduled jobs for that user, or run the import as another user. Guide: Import Wizard.

EM4SF_SUBSCRIBER_STATS_GENERAL

What this means: Importing Emma statistics into Salesforce failed.

Common causes: Emma maintenance; network issue; transient save error.

What to do: Usually recovers on the next sync. Check Maintenance if it repeats. Guide: Manage General Settings.

EM4SF_SUBSCRIBER_STATS

What this means: Updating Salesforce with Emma subscriber statistics failed.

Common causes: Emma maintenance; network issue; transient save error.

What to do: Usually recovers on the next sync. Check Maintenance if it repeats. Guide: Manage General Settings.

EM4SF_STORAGE_FULL

What this means: Salesforce storage is full, so Emma sync or import cannot save records.

Common causes: Org data or file storage limit reached.

What to do: Free Salesforce storage or purchase more space, then retry. Guide: Manage General Settings.

EM4SF_SERVICE_NOT_AVAILABLE

What this means: Emma was temporarily unavailable.

Common causes: Emma maintenance; network outage; API downtime.

What to do: Retry later. Contact support if it lasts more than 24 hours. Guide: Troubleshooting.

EM4SF_SCHEDULED_IMPORT

What this means: A scheduled Import Wizard job was delayed or could not run as planned.

Common causes: Too many scheduled jobs; org queue congestion.

What to do: Space out schedules and confirm the run-as user is still active. Guide: Import Wizard.

EM4SF_SCHEDULE

What this means: Scheduling or running an Emma sync or import job was delayed or failed.

Common causes: Too many scheduled jobs in the org; colliding Import Wizard schedules.

What to do: Space out Import Wizard jobs and reduce overlapping schedules. Guide: Import Wizard.

EM4SF_RUNNING_SYNC_CHECK

What this means: Emma could not check how many sync jobs are currently running.

Common causes: Primary sync user missing Emma Admin; Apex job visibility restricted.

What to do: Assign Emma Admin to the Primary Sync user. Guide: Permissions.

EM4SF_REPORT_TOO_LARGE

What this means: The Import Wizard report has too many rows. Maximum is 50,000.

Common causes: Unfiltered report; large audience export.

What to do: Add filters to reduce rows, or use a List View or another import source. Guide: Import Wizard.

EM4SF_REPORT_IMPORT_ROW_COUNT

What this means: Import Wizard could not read row metadata from the Salesforce report.

Common causes: Corrupted or non-tabular report.

What to do: Edit and save the report as Tabular, then retry the import. Guide: Import Wizard.

EM4SF_REPORT_IMPORT_FINISH

What this means: Finishing a Report-based Import Wizard job failed.

Common causes: Report errors; save failures at wrap-up; permissions.

What to do: Confirm the report runs correctly in Salesforce, then re-run the import. Guide: Import Wizard.

EM4SF_REPORT_CORRUPTED

What this means: The Salesforce report used by Import Wizard looks corrupted or unsupported.

Common causes: Non-tabular report; broken report definition.

What to do: Open the report Id from the message, save it as a Tabular report, then re-run the import. Guide: Import Wizard.

EM4SF_REFRESH_MAPPINGS

What this means: Bulk updating Emma with custom field mappings failed.

Common causes: Emma temporarily unavailable; same import ran within the past hour.

What to do: Read the Maintenance message. Wait an hour if you just ran a refresh, then try again. Guide: Field Mappings.

EM4SF_RATE_LIMIT

What this means: Emma API rate limit was exceeded.

Common causes: Too many sync or import callouts in a short window.

What to do: Wait about an hour, reduce concurrent Import Wizard jobs, then retry. Guide: Troubleshooting.

EM4SF_PROXY

What this means: Emma could not read Salesforce metadata needed for list views or page layouts.

Common causes: Missing permissions; IP restrictions; metadata access failure.

What to do: Confirm Emma Admin and metadata access for the running user. Guide: Permissions.

EM4SF_PROCESS_BATCH_TOO_MANY

What this means: Too many Salesforce batch jobs are already running to start another Emma job.

Common causes: Other packages or Import Wizard jobs saturating the org.

What to do: Usually safe to ignore. Space out imports and retry when the queue is quieter. Guide: Import Wizard.

EM4SF_PROCESS_BATCH_ITEM_EXECUTE

What this means: Processing a queued Contact or Lead change that syncs to Emma failed.

Common causes: Transient error; permissions; Emma temporarily unavailable.

What to do: Often safe to ignore because the system retries. Check Maintenance if it repeats. Guide: Troubleshooting.

EM4SF_PROCESS_BATCH_ITEM

What this means: A Salesforce governor limit was hit while adding or updating Emma members in bulk.

Common causes: Batch size too large; heavy automation; missing permission set.

What to do: Retry with a smaller batch and confirm the user has the Emma permission set. Guide: Import Wizard.

EM4SF_PROCESS_BATCH_FINISH

What this means: Cleaning up after an async Emma batch failed.

Common causes: User who started the job lacks abort or cleanup permissions.

What to do: Confirm the run-as user has Emma permissions. The next sync often clears leftovers. Guide: Troubleshooting.

EM4SF_PERMISSION_EXCEPTION

What this means: A Salesforce permissions error blocked an Emma operation.

Common causes: Missing object or field access; missing Emma permission set.

What to do: Review the Maintenance message and grant the required permissions. Guide: Permissions.

EM4SF_PAGE_LAYOUT_ERROR

What this means: Page layout setup failed due to insufficient privileges.

Common causes: User cannot edit layouts; missing Emma Admin; metadata access blocked.

What to do: Assign correct permissions and retry layout setup. Guide: Permissions.

EM4SF_PAGE_LAYOUT

What this means: Adding Emma related lists to page layouts failed.

Common causes: Insufficient privileges; metadata access; missing Emma permissions.

What to do: Assign Emma Admin and retry page layout setup. Guide: Permissions.

EM4SF_NO_ADMIN_PERMISSION

What this means: The current user cannot manage Emma permission sets on the Security screen.

Common causes: Missing access to Permission Sets; not an Emma Admin.

What to do: Use a Salesforce admin or Emma Admin user to open Security settings. Guide: Permissions.

EM4SF_MISSING_ACCOUNT_LISTVIEW

What this means: Import Wizard could not find the Emma account for a List View import.

Common causes: Salesforce not connected to Emma; wrong or missing account selection.

What to do: Reconnect to Emma and confirm the Import Wizard schedule uses a valid Emma account. Guide: Import Wizard.

EM4SF_MAILING_STATS_GENERAL

What this means: Pulling mailing statistics from Emma into Salesforce failed.

Common causes: Temporary Emma or API issue; network outage.

What to do: Usually recovers on the next sync. If it persists, contact support. Guide: Mailing History.

EM4SF_MAILING_RATES

What this means: Calculating open and click rates for mailings failed.

Common causes: Custom triggers conflicting with saves; data inconsistencies; permissions.

What to do: Read the Maintenance message. Check custom automation on mailing objects, then retry. Guide: Mailing History.

EM4SF_MAILING_HISTORY

What this means: Pulling email tracking history from Emma into Salesforce failed.

Common causes: Temporary Emma or API issue; rate limits; permissions.

What to do: Usually recovers on the next sync. If it persists, contact support. Guide: Mailing History.

EM4SF_LICENCE_UPDATE

What this means: Updating Emma licence details failed.

Common causes: Temporary licensing API issue; network failure; permissions.

What to do: Retry later. Contact support if licence features stay incorrect for more than 24 hours. Guide: Manage Billing.

EM4SF_LICENCE_SCHEDULE

What this means: The scheduled job that keeps Emma licence details up to date failed.

Common causes: Scheduler permissions; connectivity to Beaufort 12 licensing.

What to do: Confirm Emma Admin is assigned and contact support if licence status stays wrong. Guide: Manage Billing.

EM4SF_JOB_RESULT

What this means: An Emma-related Salesforce Apex job finished with a result that needs review.

Common causes: Failed or aborted sync or refresh; governor limits; callout errors.

What to do: Open Maintenance for the full message. Check Apex Jobs, fix the cause, then retry sync. Guide: Manage General Settings.

EM4SF_INSTALL

What this means: Automatic Emma permission set assignment during install failed.

Common causes: Installer lacked permission-set access; org security restrictions.

What to do: Manually assign Emma permission sets from Emma Settings, Security. Guide: Permissions.

EM4SF_IMPORT_WIZARD_REPORT

What this means: A Report-based Import Wizard job failed while updating Salesforce records.

Common causes: Save or validation errors; locking; invalid mappings.

What to do: Read the Maintenance message. Fix the report or mappings issue and re-run the import. Guide: Import Wizard.

EM4SF_IMPORT_WIZARD_PERMISSIONS

What this means: Import Wizard could not access the Salesforce report or folder.

Common causes: Missing report or folder access; run-as user lacks permissions.

What to do: Grant the Import Wizard user read access to the report and folder, then retry. Guide: Import Wizard.

EM4SF_IMPORT_WIZARD_LISTVIEW

What this means: A List View Import Wizard job failed while processing Salesforce records.

Common causes: Empty or invalid mappings; locking issues; save errors.

What to do: Read the Maintenance message. Re-check the List View mappings and retry. Guide: Import Wizard.

EM4SF_GET_MAPPINGS

What this means: Import Wizard could not load saved field mappings for a schedule.

Common causes: Corrupted mapping data; customised objects or fields; permissions.

What to do: Open the Import Wizard schedule, re-save mappings, and retry. Guide: Import Wizard.

EM4SF_FLEX_QUEUE_LIMIT

What this means: An Import Wizard job could not start because the Salesforce flex queue is full.

Common causes: Too many Apex jobs already queued or running in the org.

What to do: Wait for other jobs to finish, space out Import Wizard schedules, then retry. Guide: Import Wizard.

EM4SF_EMAIL_RENAME

What this means: Updating Emma when a Salesforce email address was renamed failed.

Common causes: Email exists on many Emma accounts; API failure; security limits across linked accounts.

What to do: Read the Maintenance message. Confirm the new email in Emma and retry if needed. Guide: Audience Members.

EM4SF_DISCONNECT

What this means: Disconnecting an Emma account from Salesforce did not complete cleanly.

Common causes: Missing delete permissions; leftover related records; unexpected error mid-disconnect.

What to do: Read the Maintenance message. Confirm the user can delete Emma account records, then retry disconnect. Guide: Installation and Setup.

EM4SF_DELETE_SUBSCRIBERS

What this means: Bulk remove or update of group members failed.

Common causes: Import Wizard jobs running too frequently; Salesforce job limits; permissions.

What to do: Space out Import Wizard jobs. Consider Emma Segments for large changes. Guide: Import Wizard.

EM4SF_CUSTOM_MAPPINGS_UPDATE

What this means: Applying custom field mappings between Emma and Salesforce failed.

Common causes: Incompatible field types; missing field-level security.

What to do: Check mapped fields use compatible types and the user can access them. Guide: Field Mappings.

EM4SF_CUSTOM_MAPPINGS_INVALID_FIELD

What this means: A field mapping references a Salesforce field that is invalid or unavailable.

Common causes: Field deleted or renamed; wrong object; missing field-level security; unsupported type.

What to do: Review Field Mappings and remove or correct the invalid field. Guide: Field Mappings.

EM4SF_CREATE_CONTACT_LEAD

What this means: Creating or updating a Salesforce Contact or Lead from an Emma member failed.

Common causes: Validation rules; picklist mismatches; wrong field types; required fields missing.

What to do: Read the Maintenance message. Fix the Salesforce save error, then retry. Guide: Creating Records.

EM4SF_CONFIG_UPDATE

What this means: Syncing base configuration from Emma to Salesforce failed.

Common causes: Invalid API keys; sandbox connected to a different org; connection error.

What to do: Reconnect to Emma and confirm API keys. Re-run Primary Sync. Guide: Installation and Setup.

EM4SF_CONFIG_STORED_LICENCE

What this means: Emma could not read or store package licence details for the current user.

Common causes: Missing Emma Admin; restricted profile; insufficient package licence access.

What to do: Sign in as an Emma Admin user and refresh Billing or licence details. Guide: Manage Billing.

EM4SF_BATCH_ADD_SUBSCRIBER_CONTACT

What this means: Adding a Salesforce Contact to Emma failed.

Common causes: Invalid Contact email; Emma API failure; missing field mappings; permissions.

What to do: Read the Maintenance message. Check the Contact email and mappings, then retry. Guide: Audience Members.

EM4SF_BATCH_ADD_SUBSCRIBER

What this means: Adding audience members to Emma failed.

Common causes: Invalid email; Emma API failure; group or account permissions; network issue.

What to do: Read the Maintenance message. Confirm the email and Emma account. Retry with a smaller batch. Guide: Audience Members.

EM4SF_ACCOUNT_HOME

What this means: Refreshing Emma groups from the Email Accounts page failed.

Common causes: Emma maintenance or network issue; temporary API failure.

What to do: Read the Maintenance message. Retry the refresh. If it keeps failing, contact support. Guide: Emma Groups.

EM4SF_CHECK_SETTINGS

What this means: Emma connection settings could not be verified.

Common causes: Invalid or missing API keys; Emma account disconnected; network issue.

What to do: Check API keys in Emma Settings and reconnect if needed. Guide: Installation and Setup.

EM4SF_BATCH_UPSERT_SUBSCRIBER

What this means: Creating or updating subscription records in Salesforce failed.

Common causes: Validation rules; duplicate emails; missing required fields; permissions.

What to do: Read the Maintenance message. Fix the Salesforce save error, then re-run sync or import. Guide: Audience Members.

EM4SF_BATCH_UPDATE_SUBSCRIBER

What this means: Updating Emma audience member records in Salesforce failed during sync or import.

Common causes: Validation rules; field type mismatches; record locks; permissions.

What to do: Read the Maintenance message. Review validation rules and field access on Subscription, Contact, and Lead. Guide: Audience Members.

EM4SF_BATCH_ADD_SUBSCRIBER_LEAD

What this means: Adding a Salesforce Lead to Emma failed.

Common causes: Invalid Lead email; Emma API failure; missing field mappings; permissions.

What to do: Read the Maintenance message. Check the Lead email and mappings, then retry. Guide: Audience Members.

EM4SF_ADMIN_PERMISSION

What this means: The Salesforce user running Primary Sync does not have the Emma Admin permission set.

Common causes: Sync user changed; permission set removed; restricted profile.

What to do: Assign Emma Admin to the Primary Sync user, then re-run Primary Sync. Guide: Permissions.

No matches. Try a different code or keyword.

NEXT GUIDE

Troubleshooting

Work through common syncing and email opt-out issues.

All Emma support guides
Emma supportFor Salesforce · By Beaufort 12

How can we help?

Guides, answers and a little human help.

Explore the support guidesSetup, features and troubleshooting Contact the teamSend us a message