Salesforce

Salesforce Ingest Job Data API

Operations for uploading CSV data to ingest jobs and retrieving job results (successful, failed, and unprocessed records).

GitHub OpenAPI

Operations 4

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

PUT /ingest/{jobId}/batches Upload CSV data to an open ingest job · Salesforce Upload Job Data (csv) #
Ask an LLM
“How do I load CSV rows into a Bulk API 2.0 job before closing it?”
“Can I upload data to the same ingest job more than once?”
Tell an agent
Upload CSV data to ingest job {job_id}.
Append another CSV batch to open job {job_id}.
GET /ingest/{jobId}/successfulResults Get successfully processed records of a job · Salesforce Get Successful Records From an Ingest Job #
Ask an LLM
“Which records in my bulk ingest job were processed successfully?”
“How do I get the IDs of records a bulk job inserted?”
Tell an agent
Get successful results for ingest job {job_id}.
Download the CSV of records job {job_id} processed successfully.
GET /ingest/{jobId}/failedResults Get failed records of an ingest job · Salesforce Get Failed Records From an Ingest Job #
Ask an LLM
“Which records failed in my bulk load and why?”
“Where do I find the sf__Error column for rows that didn't load?”
Tell an agent
Get failed records for ingest job {job_id}.
Download the errors CSV for job {job_id} so I can fix and resubmit.
GET /ingest/{jobId}/unprocessedrecords Get unprocessed records of an ingest job · Salesforce Get Unprocessed Records From an Ingest Job #
Ask an LLM
“Which rows were never processed because my bulk job was aborted?”
“How do I recover records to resubmit after aborting an ingest job?”
Tell an agent
Get unprocessed records for ingest job {job_id}.
Download the rows job {job_id} never processed.

Documentation

📖
Documentation
https://developer.salesforce.com/docs/atlas.en-us.api_bulk_v2.meta/api_bulk_v2/
📖
APIReference
https://developer.salesforce.com/docs/atlas.en-us.api_bulk_v2.meta/api_bulk_v2/get_job_info.htm
📖
Authentication
https://developer.salesforce.com/docs/atlas.en-us.api_bulk_v2.meta/api_bulk_v2/bulk_api_2_0_security.htm
📖
Documentation
https://developer.salesforce.com/docs/atlas.en-us.uiapi.meta/uiapi/
📖
GettingStarted
https://developer.salesforce.com/docs/atlas.en-us.uiapi.meta/uiapi/ui_api_get_started.htm
📖
APIReference
https://developer.salesforce.com/docs/atlas.en-us.uiapi.meta/uiapi/ui_api_resources_list.htm
📖
Documentation
https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/rest-api.html
📖
GettingStarted
https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/get-started-spec.html
📖
APIReference
https://developer.salesforce.com/docs/marketing/marketing-cloud/references/mc_rest_overview.html
📖
Authentication
https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/access-token-s2s.html
📖
Documentation
https://developer.salesforce.com/

Specifications

⚙
OpenAPI
https://artifacts.apis.io/salesforce/openapi/salesforce-ingest-job-data-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/salesforce/json-schema/salesforce-bulk-job-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/salesforce:salesforce-ingest-job-data-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

salesforce-ingest-job-data-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Salesforce Bulk API 2.0 Ingest Job Data API
  description: Salesforce Bulk API 2.0 is a simplified, REST-based interface for bulk data operations that improves on the original Bulk API. It uses a straightforward job model and supports CSV format for ingest and query jobs, enabling processing of millions of records asynchronously.
  version: v63.0
  contact:
    name: Salesforce Developers
    url: https://developer.salesforce.com/
  license:
    name: Salesforce Developer Terms
    url: https://www.salesforce.com/company/legal/agreements/
servers:
- url: https://{instance}.salesforce.com/services/data/v{version}/jobs
  description: Salesforce Bulk API 2.0 jobs endpoint
  variables:
    instance:
      default: yourInstance
      description: 'The Salesforce instance identifier (e.g., na1, eu3, or a My Domain subdomain like mycompany).

        '
    version:
      default: '63.0'
      description: 'The Salesforce API version number (e.g., 63.0). Use the latest supported version for new integrations.

        '
security:
- BearerAuth: []
tags:
- name: Ingest Job Data
  description: Operations for uploading CSV data to ingest jobs and retrieving job results (successful, failed, and unprocessed records).
paths:
  /ingest/{jobId}/batches:
    put:
      operationId: uploadJobData
      summary: Salesforce Upload Job Data (csv)
      description: Uploads CSV data to an ingest job that is in the Open state. The CSV must include a header row matching the field API names for the object. Multiple upload calls can be made for the same job; data is appended. After uploading all data, close the job with PATCH /ingest/{jobId} to begin processing.
      tags:
      - Ingest Job Data
      parameters:
      - $ref: '#/components/parameters/jobId'
      requestBody:
        required: true
        description: 'CSV data to upload to the ingest job. The first row must be a header row with field API names.

          '
        content:
          text/csv:
            schema:
              type: string
              format: binary
              description: 'CSV-formatted data with a header row and one record per subsequent row. Field names in the header must match the Salesforce field API names for the object.

                '
            examples:
              UploadjobdataRequestExample:
                summary: Default uploadJobData request
                x-microcks-default: true
                value: example_value
      responses:
        '201':
          description: Data uploaded successfully to the ingest job.
        '400':
          description: 'Bad request. Invalid CSV format, job not in Open state, or data exceeds size limits.

            '
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                Uploadjobdata400Example:
                  summary: Default uploadJobData 400 response
                  x-microcks-default: true
                  value:
                    message: example_value
                    errorCode: example_value
                    fields:
                    - example_value
        '401':
          description: Unauthorized. Invalid or expired OAuth token.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                Uploadjobdata401Example:
                  summary: Default uploadJobData 401 response
                  x-microcks-default: true
                  value:
                    message: example_value
                    errorCode: example_value
                    fields:
                    - example_value
        '404':
          description: Job not found for the specified job ID.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                Uploadjobdata404Example:
                  summary: Default uploadJobData 404 response
                  x-microcks-default: true
                  value:
                    message: example_value
                    errorCode: example_value
                    fields:
                    - example_value
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /ingest/{jobId}/successfulResults:
    get:
      operationId: getSuccessfulResults
      summary: Salesforce Get Successful Records From an Ingest Job
      description: Returns a CSV file containing the records that were successfully processed by the ingest job. Each row corresponds to a record from the uploaded data that was inserted, updated, upserted, or deleted successfully. Only available after the job reaches JobComplete state.
      tags:
      - Ingest Job Data
      parameters:
      - $ref: '#/components/parameters/jobId'
      responses:
        '200':
          description: 'CSV data containing the successfully processed records, with sf__Id and sf__Created columns added.

            '
          content:
            text/csv:
              schema:
                type: string
                description: 'CSV data of successfully processed records. Includes sf__Id (the Salesforce record ID) and sf__Created (true if created, false if updated) columns.

                  '
              examples:
                Getsuccessfulresults200Example:
                  summary: Default getSuccessfulResults 200 response
                  x-microcks-default: true
                  value: example_value
        '401':
          description: Unauthorized. Invalid or expired OAuth token.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                Getsuccessfulresults401Example:
                  summary: Default getSuccessfulResults 401 response
                  x-microcks-default: true
                  value:
                    message: example_value
                    errorCode: example_value
                    fields:
                    - example_value
        '404':
          description: Job not found or job has not completed processing.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                Getsuccessfulresults404Example:
                  summary: Default getSuccessfulResults 404 response
                  x-microcks-default: true
                  value:
                    message: example_value
                    errorCode: example_value
                    fields:
                    - example_value
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /ingest/{jobId}/failedResults:
    get:
      operationId: getFailedResults
      summary: Salesforce Get Failed Records From an Ingest Job
      description: Returns a CSV file containing the records from the ingest job that failed to process. Each row includes the original record data plus sf__Error and sf__Id columns describing the failure reason. Use this to identify and fix records that need to be resubmitted.
      tags:
      - Ingest Job Data
      parameters:
      - $ref: '#/components/parameters/jobId'
      responses:
        '200':
          description: 'CSV data containing failed records with error details in the sf__Error column.

            '
          content:
            text/csv:
              schema:
                type: string
                description: 'CSV data of failed records. Includes sf__Error (error message describing the failure) and sf__Id (the record ID if applicable) columns.

                  '
              examples:
                Getfailedresults200Example:
                  summary: Default getFailedResults 200 response
                  x-microcks-default: true
                  value: example_value
        '401':
          description: Unauthorized. Invalid or expired OAuth token.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                Getfailedresults401Example:
                  summary: Default getFailedResults 401 response
                  x-microcks-default: true
                  value:
                    message: example_value
                    errorCode: example_value
                    fields:
                    - example_value
        '404':
          description: Job not found or job has not completed processing.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                Getfailedresults404Example:
                  summary: Default getFailedResults 404 response
                  x-microcks-default: true
                  value:
                    message: example_value
                    errorCode: example_value
                    fields:
                    - example_value
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /ingest/{jobId}/unprocessedrecords:
    get:
      operationId: getUnprocessedRecords
      summary: Salesforce Get Unprocessed Records From an Ingest Job
      description: Returns a CSV file containing the records from the ingest job that were not processed, typically because the job was aborted before processing completed. Use these records to resubmit them in a new job.
      tags:
      - Ingest Job Data
      parameters:
      - $ref: '#/components/parameters/jobId'
      responses:
        '200':
          description: CSV data containing unprocessed records from the aborted job.
          content:
            text/csv:
              schema:
                type: string
                description: 'CSV data of unprocessed records in the same format as the original uploaded data.

                  '
              examples:
                Getunprocessedrecords200Example:
                  summary: Default getUnprocessedRecords 200 response
                  x-microcks-default: true
                  value: example_value
        '401':
          description: Unauthorized. Invalid or expired OAuth token.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                Getunprocessedrecords401Example:
                  summary: Default getUnprocessedRecords 401 response
                  x-microcks-default: true
                  value:
                    message: example_value
                    errorCode: example_value
                    fields:
                    - example_value
        '404':
          description: Job not found for the specified job ID.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                Getunprocessedrecords404Example:
                  summary: Default getUnprocessedRecords 404 response
                  x-microcks-default: true
                  value:
                    message: example_value
                    errorCode: example_value
                    fields:
                    - example_value
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
components:
  schemas:
    Error:
      type: object
      description: An error response from the Salesforce Bulk API 2.0.
      properties:
        message:
          type: string
          description: Human-readable description of the error.
          example: example_value
        errorCode:
          type: string
          description: Salesforce error code identifying the type of error.
          example: example_value
        fields:
          type: array
          description: List of field names related to the error, if applicable.
          items:
            type: string
          example: []
  parameters:
    jobId:
      name: jobId
      in: path
      required: true
      description: The unique identifier of the Bulk API 2.0 job.
      schema:
        type: string
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: 'OAuth 2.0 Bearer token obtained from the Salesforce OAuth 2.0 token endpoint. Include this token in the Authorization header as "Bearer {access_token}".

        '