Create a Job

Creates a job representing a bulk ingest operation used to send data to Salesforce CDP. Job data is provided via an Upload Job Data request. Creating a data stream in Salesforce CDP is a prerequisite for this feature.

All fields must be provided in the request payload as defined in the schema regardless of whether Value Required is true or not. The Value Required is applicable to the value of the fields only. We recommend entering a blank value for fields not set as required.

Note

Creating a data stream in Salesforce CDP is a prerequisite for this feature.

Syntax

URI

/api/v1/ingest/jobs

Available since release

Salesforce CDP v1.0, Salesforce v51.0

Formats

TEXT/CSV

HTTP methods

POST

Authentication

Authorization: Bearer access_token

Request body

1{
2   "object":"my_object",
3   "sourceName":"my_api_connector",
4   "operation":"upsert"
5}

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 connector that represents the source of the object.

Response body

1HTTP/1.1 201 Created
2{
3       "id": "4d5a4477-e27f-4bc1-a219-31e79407eade",
4       "operation": "upsert",
5       "object": "my_object",
6       "sourceName": "my_api_connector",
7       "createdById": "005R0000000sJ1hIAE",
8       "createdDate": "2021-04-05T13:35:31.000Z",
9       "systemModstamp": "2021-04-05T13:35:31.000Z",
10       "state": "Open",
11       "contentType": "CSV",
12       "apiVersion": v1,
13       "contentUrl": "api/v1/ingest/jobs/4d5a4477-e27f-4bc1-a219-31e79407eade/batches"
14}

Salesforce CDP API Developer Guide

Create a Job

Syntax