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.

Note

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

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.
`emptyRecycleBin()`	Delete records from the recycle bin immediately.
`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.