Newer Version Available

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

Datacloud Orders

Purchases the contacts or companies for the listed IDs. The POST request can have either contact IDs or Company IDs not both. orderInput.

Purchase contacts or companies in a single POST request, and specify .

Resource
1/connect/datacloud/orders
Available version
32.0
Requires Chatter
No
HTTP methods
POST
Request body for POST
Root XML tag
<DatacloudOrder>
JSON example
1{
2   "companyIds":[
3      "23456",
4      "24548"
5   ],
6   "userType":"Monthly"
7}
Properties
Name Type Description Required or Optional Available Version
companyIds String The list of companies to purchase. If contactIds are included with companyIds, your purchase fails. Required 32.0
contactIds String The list of contacts to purchase. We recommend that you include only contacts in your list. If companyIds are included with contactIds, your purchase fails. Required 32.0
userType String The Data.com user type.
  • Monthy—A user type that’s assigned monthly point limits for purchasing Data.com records. Only the assigned user can use monthly points. Points expire at the end of the month. Monthly is the default setting for DatacloudUserType.
  • Listpool— A user type that allows users to draw from a pool of points to purchase Data.com records.
Optional—If a user type isn’t specified, Monthly is the default. 32.0
Request parameters for POST
Parameter Name Type Description Required or Optional Available Version
orderInput Object A request body with a list of contact or company IDs. Required 32.0
Response body for POST
DatacloudOrderRepresentation