---
schema_version: "1"
id: 8796d9c47c85593b134bc443ac58a2152376799bab185a94dea69bf79e80a7d2
title: Create a Job
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/data-cloud/data-cloud-int/references/ingestionapi/c360-a-api-create-a-job.md
canonical_url: https://developer.salesforce.com/docs/data/data-cloud-int/references/data-cloud-ingestionapi-ref/c360-a-api-create-a-job.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 56aa645f160aee5244aced4c9e3276066a35e04e87deae73510f84cc026c602d
products:
  - Data 360 Integration Guide
  - Data 360 Developer Documentation
---
# Create a Job

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

Creating a [data stream](https://help.salesforce.com/s/articleView?id=data.c360_a_data_ingestion.htm&type=5) 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](https://developer.salesforce.com/docs/data/data-cloud-int/references/data-cloud-ingestionapi-ref/c360-a-api-upload-job-data.md) 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](https://developer.salesforce.com/docs/data/data-cloud-int/references/data-cloud-ingestionapi-ref/c360-a-api-get-started.html).

- Available since release

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

- Formats

  - : JSON

- HTTP methods

  - : POST

- Authentication

  - : `Authorization: Bearer {access_token}`

- Request body

  - :

    ```nolang
    {
      "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.

    ```nolang
    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"
    }
    ```