Newer Version Available

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

Core Calls

The following table lists supported calls in the API in alphabetical order, and provides a brief description for each. Click a call name to see syntax, usage, and more information for that call.

For a list of API utility calls, see Utility Calls, and for a list of describe calls, see Describe Calls.

Note

Call Description
convertLead() Converts a Lead into an Account, Contact, or (optionally) an Opportunity.
create() Adds one or more new individual objects to your organization’s data.
delete()

Deletes one or more individual objects from your organization’s data.

deleteByExample()

Deletes objects from your organization’s data using an sObject as a template for what to delete. All data in a big object matching the values in the sObject templates are deleted.

emptyRecycleBin()

Delete records from the recycle bin immediately.

findDuplicates() Performs rule-based searches for duplicate records. The input is an array of sObject, each of which specifies the values to search for and the type of object that supplies the duplicate rules. The output identifies the detected duplicates for each object that supplies the duplicate rules. findDuplicates() applies the rules to the values to do the search. The output identifies the detected duplicates for each sObject.
getDeleted() Retrieves the IDs of individual objects of the specified object that have been deleted since the specified time. For information on IDs, see ID Field Type.
getUpdated() Retrieves the IDs of individual objects of the specified object that have been updated since the specified time. For information on IDs, see ID Field Type.
invalidateSessions()

Ends one or more sessions specified by sessionId.

login() Logs in to the login server and starts a client session.
logout()

Ends the session of the logged-in user.

merge()

Merges records of the same object type.

process() Submits an array of approval process instances for approval, or processes an array of approval process instances to be approved, rejected, or removed.
query() Executes a query against the specified object and returns data that matches the specified criteria.
queryAll() Same as query(), but includes deleted and archived items.
queryMore() Retrieves the next batch of objects from a query.
retrieve() Retrieves one or more objects based on the specified object IDs.
search() Executes a text search in your organization’s data.
undelete() Undelete records identified with queryAll().
update() Updates one or more existing objects in your organization’s data.
upsert() Creates new objects and updates existing objects; matches on a custom field to determine the presence of existing objects.

Samples

The samples in this section are based on the enterprise WSDL file. They assume that you have already imported the WSDL file and created a connection. To learn how to do so, see the Quick Start tutorial.