Creating a New Job

Create a new job by sending a POST request to the following URI. The request body identifies the type of object processed in all associated batches.

URI

https://instance_name—api.salesforce.com/services/async/APIversion/job

Example request body

1<?xml version="1.0" encoding="UTF-8"?>
2<jobInfo
3   xmlns="http://www.force.com/2009/06/asyncapi/dataload">
4 <operation>insert</operation>
5 <object>Account</object>
6 <contentType>CSV</contentType>
7</jobInfo>

In this sample, the contentType field indicates that the batches associated with the job are in CSV format. For alternative options, such as XML, see JobInfo.

The operation value must be all lower case. For example, you get an error if you use INSERT instead of insert.

Warning

Example response body

1<?xml version="1.0" encoding="UTF-8"?>
2<jobInfo
3   xmlns="http://www.force.com/2009/06/asyncapi/dataload">
4 <id>750D0000000002lIAA</id>
5 <operation>insert</operation>
6 <object>Account</object>
7 <createdById>005D0000001ALVFIA4</createdById>
8 <createdDate>2009-04-14T18:15:59.000Z</createdDate>
9 <systemModstamp>2009-04-14T18:15:59.000Z</systemModstamp>
10 <state>Open</state>
11 <contentType>CSV</contentType>
12</jobInfo>