Create a Job

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

Creating a data stream in Data 360 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

  • : {instance_url}/api/v1/ingest/jobs

    Use the instance_url from the Data 360 token exchange response. See Get Started with Ingestion API.

• Available since release

  • : Data 360 v1.0, Salesforce v51.0

• Formats

  • : JSON

• HTTP methods

  • : POST

• Authentication

  • : Authorization: Bearer {access_token}

• Request body

  • :

    {
      "object":"my_object",
      "sourceName":"my_api_connector",
      "operation":"upsert"
    }
    

note: 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.

    HTTP/1.1 201 Created
    {
      "id": "4d5a4477-e27f-4bc1-a219-31e79407eade",
      "operation": "upsert",
      "object": "my_object",
      "sourceName": "my_api_connector",
      "createdById": "005R0000000sJ1hIAE",
      "createdDate": "2021-04-05T13:35:31.000Z",
      "systemModstamp": "2021-04-05T13:35:31.000Z",
      "state": "Open",
      "contentType": "CSV",
      "apiVersion": v1,
      "contentUrl": "api/v1/ingest/jobs/4d5a4477-e27f-4bc1-a219-31e79407eade/batches"
    }