Maintenance
6 minute read

Maintenance

This screen focuses on maintenace allowing you access to error logs, page setup and internal governor limits.

Maintenance Codes

Should you get an error in Mailchimp we will attempt to log it into messages. If you click on the error message you will get more details on the problem. Below is a full list of all error codes.
ERROR_GENERIC

Mailchimp has returned a generic error message. You might encounter this error when importing Salesforce records into Mailchimp. This Mailchimp error is typically followed by a more descriptive message. e.g. test@example.com has signed up to a lot of lists very recently; we're not allowing more signups for now.

MC4SF_WIZARD_SOQL_MISSING_EMAIL

When running a List view/SOQL/Campaign based Data Wizard job, the Mailchimp email field was not mapped. Review the mappings for the job and check that an email field is mapped.

MC4SF_WIZARD_SOQL_MISSING_ACCOUNT

The Mailchimp account associated with the List view/SOQL/Campaign based Data Wizard job was missing. Check that the Mailchimp account is connected. Consider recreating the Data Wizard job. The associated ID refers to the Data Wizard record.

MC4SF_WIZARD_SOQL_JOB_ERROR

A problem was found in the Apex Logs for the Data Wizard batch job related to a Salesforce List View, SOQL or Salesforce Campaign. Check the associated error for details.

MC4SF_WIZARD_REPORT_INVALID

The Salesforce report associated with the Data Wizard was corrupted or not compatible. Re-save the Salesforce report as tabular and try the Wizard again.

MC4SF_WIZARD_REPORT_TOO_LARGE

The Salesforce report associated with the Data Wizard was too large. The report may contain a maximum of 50,000 records. Consider using a List View or SOQL based Data Wizard as these have no practical limit.

MC4SF_WIZARD_REPORT_IMPORT_ROW_COUNT_GENERAL

The Salesforce report associated with the Data Wizard was not compatible or corrupted. Re-save the Salesforce report as tabular and try the Wizard again.

MC4SF_WIZARD_REPORT_IMPORT_ROW_COUNT

The Salesforce report associated with the Data Wizard was not compatible or corrupted. Re-save the Salesforce report as tabular and try the Wizard again.

MC4SF_WIZARD_REPORT_SETUP_ERROR

An error occurred whilst preparing a report for the Data Wizard. The associated ID refers to the Data Wizard record. Check this record refers to a Salesforce report that a) the user has access to or exists, b) that the report is not corrupted - edit the report and save it again.

MC4SF_WIZARD_REPORT_MISSING_EMAIL

When running a report based Data Wizard job, the Mailchimp email field was not mapped. Review the mappings for the job and check that an email field is mapped.

MC4SF_WIZARD_REPORT_MISSING_ACCOUNT

The Mailchimp account associated with the report-based Data Wizard job was missing. Check that the Mailchimp account is connected. Consider recreating the Data Wizard job. The associated ID refers to the Data Wizard record.

MC4SF_WIZARD_REPORT_JOB_ERROR

A problem was found in the Apex logs for the Data Wizard batch job related to a Salesforce report. Check the associated error for details.

MC4SF_LIST_VIEW_PROXY

An error occurred whilst attempting to retrieve List view metadata from Salesforce. If the problem persists, contact Beaufort 12 support.

MC4SF_NO_ADMIN_PERMISSION

Unable to retrieve details of Salesforce users when managing permissions on the user security screen. See: https://www.beaufort12.com/mailchimp/support/user-security

MC4SF_ORG_CHECK

When running the sync, we check what version the Salesforce Org is configured with. This error means the running user (i.e. the user assigned to run the primary sync) doesn't have permissions to view the Organization object. Check the user has the “View Setup and Configuration” permission.

MC4SF_RUNNING_SYNC_CHECK

An error occurred whilst trying to check the sync status. This is likely to be a permissions issue. Users must have the “View Setup and Configuration” permission.

MC4SF_DEFAULT_VALUE

The default value provided in the Mappings screen (direction of Mailchimp to Salesforce), is invalid for the selected Salesforce field. Check the default value and ensure it matches the data type in Salesforce or that it matches any validation rules etc.

MC4SF_RULE_EXCEPTION

Rules are used to process Mailchimp record in Salesforce. For example, you may have configured the Rule to create a Salesforce contact for new Mailchimp members. This exception can occur for a number of reasons, e.g. the contact record has strict validation rules which cannot be met with Mailchimp data. Use the Validation button on the Mappings screen to check for issues. Typically the associated error will contain the reason for the error.

MC4SF_PROCESS_BATCH_ITEM

An error occurred whilst attempting to update a Mailchimp record with Salesforce data. This may occur when a Salesforce user triggers an update on a contact, which in turn checks if there is a linked Mailchimp Member. It then attempts to update Mailchimp with the mapped Salesforce details. Most of the time, the trigger action is completely unrelated to Mailchimp, but if the fields are mapped, we always need to check if the data needs to be synced from Salesforce to Mailchimp (i.e. the error can typically be ignored). It's at this time an error might occur. E.g. it could be the update was triggered by a Salesforce user with limited permissions and no access to Mailchimp. See associated error for details.

MC4SF_MISSING_RECORDS

This is an internal warning. It indicates that there were no Members provided for processing. It's possible the Member has already been deleted in Salesforce or is not accessible due to permission issues.

MC4SF_IMPORT_WARNING

A general warning occurred whilst attempting to push a Salesforce record to Mailchimp. Check the associated message for details.

MC4SF_MISSING_EMAIL_FIELD

The Salesforce email field was not specified when attempting to push a Salesforce record to Mailchimp, e.g. if you are pushing a Contact record from Salesforce to Mailchimp, check that you have the Contact email field mapped on the Field mappings screen (either the Data Wizard mappings or the generic Field mappings screen, in the direction of Salesforce to Mailchimp).

MC4SF_MISSING_LIST

The Audience supplied when attempting to push a Salesforce record to Mailchimp was missing. Check the sync has run and that the list exists in Mailchimp.

MC4SF_ARCHIVE_MEMBERS_CALLOUT

When attempting to set Mailchimp Members to archived, the Salesforce callout limit was reached. If you are processing Members in bulk, consider reducing the batch size.

MC4SF_ARCHIVE_WARNING

Only Mailchimp members in a certain status can be set to archived. You cannot archive a contact that is bounced, pending or archived. See: https://mailchimp.com/help/archive-unarchive-contacts/

MC4SF_INVALID_EMAIL

The email address being sent to Mailchimp is in the incorrect format. Check the email address for incorrect characters, spaces, dots etc.

MC4SF_UPDATE_MEMBERS

An error occurred whilst trying to update or insert a Mailchimp Member in Salesforce. Check the associated error for more details. Also check the use has one of our permissions sets. See: https://www.beaufort12.com/mailchimp/support/user-security

MC4SF_UPSERT_LIST

An error occurred whilst trying to save changes to Mailchimp Audience (list) record. This could result in the Audience details not being updated in Mailchimp. Check the associated error for more details.

MC4SF_LAYOUT_EMPTY

We will automatically attempt to add the Mailchimp Members component to the default page layout. However, this is only possible if the Salesforce Contact or Lead layout already has a lightning page activated. If we cannot automatically add the layout, you we get this maintenance code and will need to manually add the components. You can find more information on that here: https://www.beaufort12.com/mc4faqs/how-can-i-manually-add-mailchimp-to-my-page-layouts

MC4SF_MEMBER_BATCH

An error occurred whilst trying to sync Mailchimp Members to Salesforce. Check the associated error for more details. In particular check the primary sync user has the correct permission set (Mailchimp Admin).

MC4SF_MEMBER_COUNT_BATCH

An error occurred whilst trying to collecting Mailchimp Member stats and Mailchimp Group information. Check the associated error for more details. In particular check the primary sync user has the correct permission set (Mailchimp Admin).

MC4SF_MEMBER_COUNT_CATEGORY

An error occurred whilst trying to update or insert Mailchimp Category information (I.e. groups/interests categories.) Check the associated error for more details.

MC4SF_LAYOUT

We will automatically attempt to add the Mailchimp Members component to the default page layout. However, this is only possible if the Salesforce Contact or Lead layout already has a lightning page activated. If we cannot automatically add the layout, you we get this maintenance code and will need to manually add the components. You can find more information on that here: https://www.beaufort12.com/mc4faqs/how-can-i-manually-add-mailchimp-to-my-page-layouts

MC4SF_UPSERT_LIST_HISTORY

An error occurred whilst trying to sync Mailchimp Audience history stats. These stats are used in Salesforce reports and with the Audience charts. Check the associated error for more details.

MC4SF_LICENCE_UPDATE

There was an issue contacting the Beaufort 12 API. This may be due to a maintenance window. If the issue persists, contact Beaufort 12 support for assistance.

MC4SF_LICENCE_SCHEDULE

There was an error when attempting to start an internal licence job name 'Mailchimp Licence'. If this occurs, your licence may be disabled. Ensure there are enough spare Salesforce scheduled jobs available.

MC4SF_SCHEDULED_WIZARD

There were too many scheduled Data Wizard jobs running. The current job will be placed back in the queue and processed later. A round-robin approach is used to jobs. This is just a warning, it means Data Wizard jobs may take longer to process than expected. Consider reducing the number of Data Wizard jobs you have running and instead consider using Mailchimp segments.

MC4SF_GROUP_BATCH

An error occurred whilst trying to sync Mailchimp Groups/Interests records to Salesforce. Check the associated error for more details.

MC4SF_ADMIN_PERMISSION

The primary sync user does not have the "Mailchimp Admin" permission set. See: https://www.beaufort12.com/mailchimp/support/user-security

MC4SF_CONFIG_STORED_LICENCE

The user does not have permission to view stored Salesforce licence information. The user needs to be granted access to the PackageLicense object. Under the user's profile enable the 'Manage Package Licenses' checkbox.

MC4SF_CONFIG_INVALID_ORG

This Sandbox was connected to a different Salesforce Org. Reconnect the Salesforce Sandbox to Mailchimp. This is to avoid accidentally using production data in a test environment.

MC4SF_ACTIVITY_BATCH

An error occurred whilst trying to update or insert detailed stored Mailchimp Email Activity records (E.g. clicks, opens etc.). Check the associated error for more details.

MC4SF_WIZARD_SOQL_SETUP_ERROR

A generic error occurred whilst processing a Data Wizard job based on a List View, SOQL or Campaign. Check the Data Wizard configuration. The Id mentioned in the error points to the Salesforce record Id for the Data Wizard. It's likely there was a permissions error, or the SOQL associated with the Wizard is incorrect.

MC4SF_IMPORT_RUN_FAILED

If the Data Wizard encounters an error when running, this error will be raised. More detail on the error can be typically be found on the Data Wizard screen using the Results menu item associated with the Wizard job.

MC4SF_TOO_MANY_SCHEDULES

When the Data Wizard runs, the app will check if enough Salesforce scheduled slots are available to schedule the Wizard. If not, this error is raised. Check Salesforce scheduled jobs for spare slots. Also check that triggers are enabled (if all triggers are disabled, the Data Wizard schedule is prevented from running).

MC4SF_IMPORT_WIZARD_PERMISSIONS

When configuring a Data Wizard based on a Salesforce report, this error may be raised if the running user does not have permissions to view Salesforce reports.

MC4SF_CONFIG

The config batch runs through each connected Mailchimp Audience and builds up information in preparation for the primary sync. The error will be accompanied by more detail. E.g. the user running the primary sync may not have the correct permissions.

MC4SF_CAMPAIGN_BATCH

There was a problem syncing Mailchimp Campaigns to Salesforce. Review the associated message for more details.

MC4SF_MISSING_AUDIENCE

The Mailchimp Audience does not exist. This can occur when attempting to refresh Mailchimp Campaigns to Salesforce. The most likely cause is that the Audience has been recently deleted directly from Mailchimp.

MC4SF_ADD_DELETE_MEMBER

There was a problem adding or removing a Member from a Mailchimp Audience. Review the associated message for more details.

Next Steps

Below are two articles that we recommend reading and the best next steps.

FAQs

Why can't I add or remove Mailchimp components to my page layouts?
Can I be notified when there is a new system message?
In this article