The Situation: A salesperson discovers that the primary email address for a lead/contact has changed. He/She changes the email address in the CRM system to reflect the new primary email for that lead/contact. Since Eloqua auto synchs use email address as the unique identifier, the auto-synch will run and try to find a match using the new email address. However, since this change has only been made in the CRM, it will not find a match in Eloqua and therefore create a duplicate record. Needless to say, this is far from ideal!



The Solution: Create an autosynch that references the Lead / Contact's history object in Use the old email address value as the unique identifier to match Eloqua's database and use the new email address value to overwrite it once a match has been made (don't worry.....if your confused, just follow the Play by Play!).



Play by Play:


1. Enable History Tracking on the Email field

Ensure that history tracking is enabled for the email field in This allows all changes made to this field to be recorded and allows us to pull this info into Eloqua. [Note: This change requires that you have Administrator privileges in]


               Your Name > Setup > Customize > Lead >









2. Create an Auto-synch in Eloqua to pull the information from history object

*The Auto-synch instructions below are specific to Leads in Salesforce. The same process can be followed for Contacts by swapping the word "Lead" for the word "Contact" in the following instructions.

** Although the screen captures show the Eloqua9 interfaces, the process is the same for Eloqua10.




Setup > Integration > Inbound > Create Data Sources > Create Data Source with External Call

Creating an external call.png


Give your new Auto-Synch a name and optionally give a description and a save folder. Ensure that the Purpose for upload is set to "Modify Email address" and the checkbox labeled "Can be scheduled for automatic execution" is checked. Click Next.



Select the type of Action to be performed, in this case we are retreiving data so select 'Retrieve', and select the entity in Salesforce from which we are trying to retrieve data from (Lead History). Lead the box labelled "Retrieve 18 character IDs" unchecked. Click Next


Select the fields that you want to pull data from on the Lead History object. Click Next


Since it is possible to track changes on multiple fields in Salesforce, we need to configure the filter so that we are only pulling in changes made on the Email address, as well as only pulling in changes that were made since the last time this Auto-synch ran successfully (see screenshot). Click Next.



Set the field mapping so that Eloqua knows which field coming in from Salesforce contains the old value and which one contains the new value (see screenshot).create_as_5.png


If you would like to receive notifications when this Synch is successful or when it fails, enter a notification email address and select when you would like to be notified. You may also allow this Auto-Synch to run every night at 10PM (default) or manually set the frequency of this call. Once you are complete, click FINISH.



3. Testing


Everything should be set up and ready to go at this point. To test this process, make a change to a Lead / contact's email address (in Salesforce) and then manually run your Auto-Synch. To manually run an Auto-synch, go to....


Setup > Integration > Inbound > Management > Auto-Synchs > (select the auto-synch you just created) > Auto-Synch Options > Run Auto-Synch (you may select ignore date filter to pull in any changes prior to configuration of this process).




Once this completes, and runs successfully, you will be able to view the contact's activity overview and the date and time of the change will be recorded.




Note: these instructions were taylored (haha get it taylor like my last name...not funny? Okay moving along ) for Salesforce however similiar solutions may be available in other CRM systems.


I hope you guys found this Play by Play helpful, I will be putting out additional Play by Play's periodically to help everyone on their Eloqua adventures. Feedback is appreciated as always.