Why do I get the error "Invalid record hashcode from bulk job"?

Question

When attempting to copy all Contact records, errors occur stating "Invalid record hashcode. Unable to find matching record from the response returned by the bulk job."

The export.json configuration is:

{
    "operation": "Upsert",
    "externalId": "Email",
    "query": "SELECT Id, Name, Email, Platform_Role__c, LastName, FirstName, Salutation, Secondary_Email__c, MailingCity FROM Contact"
}

Console output indicates:

[WARN][Batch#7502g000000rYc5AAE:Insert] {Contact} Incompleted.
51901 records succeeded, 592 records failed.

Despite the warning, no Contact records were successfully inserted into the target.

Answer

By default, the plugin uses Bulk API V2.0.

This warning means SFDMU could not reliably match one or more API result rows back to source records for that batch.

Recommended mitigations:

  • keep Id in query fields for Update/Upsert scenarios,
  • reduce batch pressure (smaller datasets/scoped queries),
  • if issue persists, switch to bulkApiVersion: "1.0" for that job/object.

Example workaround:

{
    "objects": [
        {
            "operation": "Upsert",
            "externalId": "Email",
            "query": "SELECT Id, Name, Email, Platform_Role__c, LastName, FirstName, Salutation, Secondary_Email__c, MailingCity FROM Contact"
        }
    ],
    "bulkApiVersion": "1.0"
}

Related Articles

Last updated on 17th Feb 2026