Loading

Bulk API 2.0 returns failed and success results with empty field values

게시 일자: May 29, 2026
상세 설명

When using Salesforce Bulk API 2.0 to ingest (upload) records, you can retrieve the results of a completed job — both successfully processed records and failed records — by calling specific API endpoints.

However, you may notice that the field values in the returned results appear as blank strings even though those same fields were populated in the original CSV file provided during the job upload.


This issue occurs when retrieving job results from the following Bulk API 2.0 endpoints:

  • For successfully processed records: /services/data/vXX.X/jobs/ingest/jobID/successfulResults/
  • For failed records: /services/data/vXX.X/jobs/ingest/jobID/failedResults/

The records are created or updated successfully in Salesforce (the operation itself does not fail), but the field values in the results response appear as empty strings instead of the expected values from the original CSV.

솔루션

This issue occurs when the field names in the CSV file header do not exactly match the Salesforce object's Field API names in terms of case sensitivity.


Bulk API 2.0 uses the CSV column headers to map data to Salesforce fields. Salesforce Field API names are case-sensitive in this context. If the column header in your CSV file uses a different case than the official Field API name — for example, using name instead of Name, or description instead of Description — Bulk API 2.0 may still process the record create or update operation without throwing an error. However, when you retrieve the job results, the API cannot match the original column header to the field, and returns an empty string for that field in the results response.

To Fix the Issue

Review your CSV file and compare each column header name against the Field API names for the Salesforce object you are loading data into. Ensure that the column headers in the CSV exactly match the Field API names, including capitalization.


For example:

  • Use Name (not name or NAME)
  • Use Description (not description)
  • Use the full API name for custom fields, such as Custom_Field__c (not custom_field__c)

 

After correcting the column headers in the CSV file, re-upload the job. The job results should then return the correct field values in the success and failure result responses.

Knowledge 기사 번호

000380583

 
로드 중
Salesforce Help | Article