Bulk API 2.0 and Bulk API Developer Guide

Introduction to Bulk API 2.0 and Bulk API
Bulk API 2.0
How Requests Are Processed
Quick Start: Bulk API 2.0
Bulk API 2.0 Ingest
Understanding Bulk API 2.0 Ingest
Prepare Data to Ingest
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
Troubleshooting Ingest Timeouts
Errors
Bulk API 2.0 Query
Headers
Limits
Bulk API 2.0 Older Documentation
Bulk API 2.0 End-of-Life Policy
Bulk API
PDF

Note: This release is in preview. Features described here don’t become generally available until the latest general availability date that Salesforce announces for this release. Before then, and where features are noted as beta, pilot, or developer preview, we can’t guarantee general availability within any particular time frame or at all. Make your purchase decisions only on the basis of generally available products and features.

Upload Job Data

Uploads data for a job using CSV data you provide.

URI: /services/data/vXX.X/jobs/ingest/jobID/batches

Availability: This resource is available in API version 41.0 and later.

Formats: text/csv

HTTP Method: PUT

Authentication: Authorization: Bearer token

Parameters: None.

Request Body

CSV file with record data.

Response Body

None. Returns a status code of 201 (Created), which indicates that the job data was successfully received by Salesforce.

Usage Notes

The resource URL is provided in the contentUrl field in the response from Create a Job, or the response from a Job Info request on an open job.

A request can provide CSV data that does not in total exceed 150 MB of base64 encoded content. When job data is uploaded, it is converted to base64. This conversion can increase the data size by approximately 50%. To account for the base64 conversion increase, upload data that does not exceed 100 MB.

Don’t delete your local CSV data until you’ve confirmed that all records were successfully processed by Salesforce. If a job fails, use the successful results, failed results, and unprocessed records resources to determine what records from your CSV data you need to resubmit.