When you sync data between two systems, like Mixmax and Salesforce, sometimes the data transfer can fail for various reasons. So, what does it mean when you see a particular error message, and how can you solve the issue? Don't worry. We've got you covered.
​
In this article, we have gathered the common errors that may occur when syncing Mixmax activities to Salesforce and how you address them.

Activities might be getting synced to Salesforce Leads, Contacts, Accounts, or Opportunities that have been deleted or to which the user does not have access. This could result from updating a record that does not exist in Salesforce or updating an object with a field set to "Read-Only" for the Mixmax user who is trying to sync the Mixmax activity to Salesforce.

To solve this error, try the following:

Review the sharing and permissions settings for the Salesforce records to which the user is trying to sync activities.

Check the objects and fields permissions settings on the Salesforce objects and fields to which the Mixmax user needs to sync. The user must have the necessary permissions to access them via their Salesforce account.

Similar to the error above, the Mixmax user is trying to sync Opened/Sent/Replied/Received/Clicked/Downloaded email activities to Salesforce objects for which this user doesn't have the necessary permissions.

Failed to log Opened: No access to Salesforce objects

Failed to log Sent: No access to Salesforce objects

Failed to log Replied: No access to Salesforce objects

Failed to log Received: No access to Salesforce objects

Failed to log Clicked: No access to Salesforce objects

Failed to log Downloaded: No access to Salesforce objects

Review the sharing and permissions settings for the Salesforce records to which the user is trying to sync activities.

Check the objects and fields permissions settings on the Salesforce objects and fields to which the Mixmax user needs to sync. The user must have the necessary permissions to access them via their Salesforce account.

Your activities might be getting synced to Salesforce Leads, Contacts, Accounts, or Opportunities that have been deleted.

The requested resource does not exist or entity is deleted

Make sure you are syncing your activities to valid and existing Salesforce records.

The "unable_to_lock_row" error occurs when multiple changes are attempted for the same record at the same time, resulting in sync failure.

UNABLE_TO_LOCK_ROW:unable to obtain exclusive access to this record:--

Mixmax will automatically retry syncing these activities, but we recommend you try adjusting your workflows to prevent multiple activity syncs or updates from happening to the same record at the same time.

Mixmax will perform automatic sync retries up to three times to reprocess the sync error. If the sync still fails after the third automatic attempt, review the error and retry the sync manually.

After attempting the sync manually, if this error persists, it is likely due to a specific workflow triggered when you try to update the field. Check with your Salesforce admin to remove the trigger setting.

Salesforce cannot log this activity or update this record because it is not valid anymore. This is typically the result of merging records in Salesforce.

INVALID_CROSS_REFERENCE_KEY:invalid cross reference id:--

Make sure you are syncing your activities to valid and existing Salesforce records.

Check your Salesforce instance to verify the access for the Mixmax user.

The Salesforce record used in the Mixmax activity sync has been deleted. This could result from updating a record that does not exist in Salesforce.

ENTITY_IS_DELETED:entity is deleted:--

Make sure you are syncing your activities to valid and existing Salesforce records.

This error is related to your Salesforce's API usage limits. Your instance limits are shared among all of the apps you have connected to Salesforce. Sometimes, just waiting for a few hours can free up your API limits since Salesforce measures API calls on a trailing 24-hour window basis.

TotalRequests Limit exceeded.

Check with your admin about possibly increasing the Salesforce API limits for Mixmax.

Check if another system is heavily using the API calls.

Increase your credits by adding more Salesforce users (each user gets a certain amount of API calls per day) or buying more API calls.

This error means that there is a validation rule that checks data before entering it into a Salesforce field. When Mixmax tries to update the field, our data hits an exception created by the validation rule when the record is updated.

Update the validation rule in Salesforce so it no longer conflicts with the data Mixmax is trying to write.

Update your Mixmax field values or automated processes so they no longer conflict with the validation rule in Salesforce.

Mixmax is trying to enter a value into a field that does not accept that type of value, e.g., sends a text value to a boolean field in Salesforce.

INVALID_TYPE_ON_FIELD_IN_RECORD

Double-check that you are entering the correct value for the field, and try again.

The error you receive concerns a field you are trying to update in Salesforce. That field is restricted by certain values that your Salesforce Admin has determined.

INVALID OR NULL FOR RESTRICTED PICKLIST

Ensure Mixmax users provide the expected values for restricted Salesforce picklists.

Add extra values to the Salesforce picklist as needed.