Create a Job

Creates a job that represents the bulk operation for loading data into the Data Cloud org.

Creating a data stream in Data Cloud is a prerequisite for creating a job. When the job is created it’s ready to accept data for processing via Upload Job Data request.

URI: /api/v1/ingest/jobs
Available since release: Data Cloud v1.0, Salesforce v51.0
Formats: JSON
HTTP methods: POST
Authentication: Authorization: Bearer {access_token}
Request body

All fields defined in the schema must be present in the request payload. This condition holds regardless of whether the Value Required is set to true or not. If there’s no data available for a certain field on a record, send in a blank value.

Request parameters

Parameter	Description
object	The object type for the data being processed. Use only a single object type per job.
operation	The processing operation for the job. Valid values are upsert and delete.
sourceName	The name of the Ingestion API connector.

Response body

The JSON response body returns a property called id that corresponds to the job id. The state is set to open, which signals that the job has been created and data can be added to the job. Retain the job id for subsequent steps.