Bulk API Developer Guide

Introduction to Bulk API
Quick Start
Set Up a Salesforce Developer Edition Organization
Install cURL
Send HTTP Requests with cURL
Step 1: Log In Using the SOAP API
Step 2: Create a Job
Step 3: Add a Batch to the Job
Step 4: Close the Job
Step 5: Check Batch Status
Step 6: Retrieve Batch Results
Plan Bulk Data Loads
Prepare Data Files
Load Binary Attachments
Request Basics
Work with Jobs
Work with Batches
Bulk Query
Reference
Sample Client Application Using Java
Map Data Fields
Glossary
PDF

Newer Version Available

This content describes an older version of this product. View Latest

Step 1: Log In Using the SOAP API

The Bulk API doesn't provide a login operation, so you must use SOAP API to log in.
  1. Create a text file called login.txt containing the following text:
    1<?xml version="1.0" encoding="utf-8" ?>
2<env:Envelope xmlns:xsd="http://www.w3.org/2001/XMLSchema"
3    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
4    xmlns:env="http://schemas.xmlsoap.org/soap/envelope/">
5  <env:Body>
6    <n1:login xmlns:n1="urn:partner.soap.sforce.com">
7      <n1:username>your_username</n1:username>
8      <n1:password>your_password</n1:password>
9    </n1:login>
10  </env:Body>
11</env:Envelope>
  2. Replace your_username and your_password with your Salesforce user name and password.
  3. Using a command-line window, execute the following cURL command:
    1curl https://login.salesforce.com/services/Soap/u/48.0 -H "Content-Type: text/xml; charset=UTF-8" -H "SOAPAction: login" -d @login.txt

    The Soap/u/ portion of the URI specifies the partner WSDL. You can use Soap/c/ to specify the enterprise WSDL.

  4. Salesforce returns an XML response that includes <sessionId> and <serverUrl> elements. Note the values of the <sessionId> element and the first part of the host name (instance), such as yourInstance-api, from the <serverUrl> element. Use these values in subsequent requests to the Bulk API.