Bulk API 2.0 Ingest

With Bulk API 2.0, you can insert, update, upsert, or delete large data sets. Prepare a comma-separated value (CSV) file representation of the data you want to upload, create a job, upload job data, and let Salesforce take care of the rest within your org.

Use CSV data when submitting data rows for Bulk API 2.0 jobs. Bulk API 2.0 supports several formatting options with CSV data, such as multiple field delimiter characters and line ending characters. Bulk API 2.0 ingest limits are described in Bulk API and Bulk API 2.0 Limits and Allocations in the Salesforce Developer Limits and Allocations Quick Reference.

  • Understanding Bulk API 2.0 Ingest

    Learn about Bulk API 2.0 availability, supported methods, and SOQL considerations.

  • Prepare Data to Ingest

    Format and organize your CSV files for upload.

  • Create a Job

    Creates a job representing a bulk operation and its associated data that is sent to Salesforce for asynchronous processing. Provide job data via an Upload Job Data request or as part of a multipart create job request.

  • Upload Job Data

    Uploads data for a job using CSV data you provide.

  • Upload Complete

    Notifies Salesforce servers that the upload of job data is complete and is ready for processing. You can’t add any more job data. This request is required for every Bulk API 2.0 ingest job. If you don’t make this request, processing of your data does not start.

  • Get Information About an Ingest Job

    Retrieves detailed information about a job.

  • Get Job Successful Record Results

    Retrieves a list of successfully processed records for a completed job.

  • Get Job Failed Record Results

    Retrieves a list of failed records for a completed insert, delete, update, upsert, refresh, or consentImport job.

  • Get Job Unprocessed Record Results

    Retrieves a list of unprocessed records for failed or aborted jobs.

  • Delete a Job

    Deletes a job. To be deleted, a job must have a state of UploadComplete, JobComplete, Aborted, or Failed.

  • Abort a Job

    If you abort a job, Salesforce doesn’t process the job.

  • Get Information About All Ingest Jobs

    Retrieves detailed information about all jobs in the org. Job records are returned in an indeterminate order.

  • Upsert Records

    Create records or update existing records (upsert) based on an ID, or the value of a specified external ID field.

  • Use Compression for Bulk API 2.0 Ingest Responses

    For ingest jobs, Bulk API 2.0 can compress the response body, which reduces network traffic and improves response time.

  • Troubleshooting Ingest Timeouts

    Solve issues encountered with Bulk API 2.0 ingest operations.

  • Errors

    Operations that you perform with Bulk API 2.0 can trigger error codes. This list shows the most common error codes and the Bulk API 2.0 action that possibly triggered them.