Bulk API 2.0 and Bulk API Developer Guide
jSummer '26 (API version 67.0)
Spring '26 (API version 66.0)
Winter '26 (API version 65.0)
Summer '25 (API version 64.0)
Spring '25 (API version 63.0)
Winter '25 (API version 62.0)
Summer '24 (API version 61.0)
Spring '24 (API version 60.0)
Winter '24 (API version 59.0)
Summer '23 (API version 58.0)
Spring '23 (API version 57.0)
Winter '23 (API version 56.0)
Summer '22 (API version 55.0)
Spring '22 (API version 54.0)
Winter '22 (API version 53.0)
Summer '21 (API version 52.0)
Spring '21 (API version 51.0)
Winter '21 (API version 50.0)
Summer '20 (API version 49.0)
Spring '20 (API version 48.0)
Winter '20 (API version 47.0)
Summer '19 (API version 46.0)
Spring '19 (API version 45.0)
Winter '19 (API version 44.0)
Summer '18 (API version 43.0)
Spring '18 (API version 42.0)
Winter '18 (API version 41.0)
Summer '17 (API version 40.0)
Spring '17 (API version 39.0)
Winter '17 (API version 38.0)
Summer '16 (API version 37.0)
Spring '16 (API version 36.0)
Winter '16 (API version 35.0)
Summer '15 (API version 34.0)
Spring '15 (API version 33.0)
Winter '15 (API version 32.0)
Summer '14 (API version 31.0)
Spring '14 (API version 30.0)
Understanding Bulk API 2.0 Ingest
Prepare CSV Files
Sample CSV Files
Valid Date Format in Records (2.0)
Relationship Fields in a Header Row (2.0)
Create a Job
Upload Job Data
Upload Complete
Get Information About an Ingest Job
Get Job Successful Record Results
Get Job Failed Record Results
Get Job Unprocessed Record Results
Delete a Job
Abort a Job
Get Information About All Ingest Jobs
Upsert Records
Use Compression for Bulk API 2.0 Ingest Responses
Errors
Limits
Bulk API 2.0 Older Documentation
Bulk API 2.0 End-of-Life Policy
Newer Version Available
Prepare Data to Ingest
Format and organize your CSV files for upload.
-
Prepare CSV Files
The first row in a CSV file lists the field names for the object that you're processing. Each subsequent row corresponds to a record in Salesforce. -
Sample CSV Files
These examples demonstrate different ways to use CSV data with Bulk API 2.0. -
Valid Date Format in Records (2.0)
Specify the right format for dateTime and date fields. -
Relationship Fields in a Header Row (2.0)
Many objects in Salesforce are related to other objects. For example, Account is a parent of Contact. You can add a reference to a related object in a CSV file by representing the relationship in a column header. When you're processing records in the Bulk API, you use RelationshipName.IndexedFieldName syntax in a CSV column header to describe the relationship between an object and its parent, where RelationshipName is the relationship name of the field and IndexedFieldName is the indexed field name that uniquely identifies the parent record. Use the describeSObjects() call in the API to get the relationshipName property value for a field.