Skip to main content

CRM: Salesforce Ingest

Submit a Salesforce Bulk API 2.0 ingest job to write records into a Salesforce object. Supports insert, upsert, update, delete, and hard-delete operations.

For read-side queries and searches use CRM::Salesforce.

Pre-requisite: Install Salesforce application in Profile > {Organization} > Applications to grant Zparse access.

Parameters

Instancerequired
Configured Salesforce application.
Endpointrequired

Currently Ingest — submit a Bulk API 2.0 ingest job.

Objectrequired

Salesforce object the ingest job targets (e.g. Account, Contact, Opportunity, custom Foo__c).

Operationrequired

Bulk API 2.0 operation to perform:

  • Insert — create new records
  • Upsert — create or update records
  • Update — update existing records
  • Delete — soft-delete records
  • Hard Delete — permanently delete records (bypasses the Recycle Bin; requires the corresponding permission)

Input

CSVrequired

A File (or Files) containing the records to ingest, in CSV format — the ingest job is always created with the CSV content type. Each file is uploaded to the submitted job.

Output

Job Response

JSON response describing the submitted ingest job (job id, status, record counts, …) returned by the Salesforce Bulk API.