Salesforce Dictionary - Free Salesforce GlossarySalesforce Dictionary
DictionarySSOAP API
DevelopmentAdvanced

SOAP API

Salesforce SOAP API is a web service interface based on the SOAP (Simple Object Access Protocol) standard that uses XML-formatted request and response messages defined by WSDL (Web Services Description Language) files.

§ 01

Definition

Salesforce SOAP API is a web service interface based on the SOAP (Simple Object Access Protocol) standard that uses XML-formatted request and response messages defined by WSDL (Web Services Description Language) files. Salesforce provides three main WSDLs: the Enterprise WSDL (strongly-typed, specific to the org's schema), the Partner WSDL (loosely-typed, generic across orgs), and the Metadata WSDL (for metadata operations such as deployments and retrievals). The Tooling WSDL is also available for developer tool integrations. SOAP API supports all standard CRUD operations (create, retrieve, update, upsert, delete, undelete), queries via SOQL and SOSL, metadata describe calls, and utility operations like merge, convertLead, and getUpdated. It is commonly used in enterprise integrations, particularly with Java and .NET platforms.

§ 02

In plain English

👋 Study buddy

Salesforce SOAP API is a web service interface based on the SOAP standard that uses XML messages defined by WSDL files. Salesforce provides Enterprise (org-specific), Partner (generic for ISVs), and Metadata WSDLs. SOAP API is commonly used in enterprise Java and .NET integrations.

§ 03

Worked example

scenario · real-world use

Tarryclough Software's legacy Java integration with their on-prem ERP system uses Salesforce's SOAP API. The integration was built in 2011 and continues to work because Salesforce maintains backward compatibility. The Java client was generated from the Enterprise WSDL, exposes typed methods like create(account[]) and query(soql), and exchanges XML SOAP envelopes over HTTPS. Modern Salesforce integrations would use REST API for new builds, but SOAP API is still the right fit for partners with SOAP-only systems and is the only option for some legacy enterprise Java/.NET stacks.

§ 04

Why SOAP API matters

Salesforce SOAP API is a web service interface based on the SOAP (Simple Object Access Protocol) standard that uses XML-formatted request and response messages defined by WSDL (Web Services Description Language) files. Salesforce provides three main WSDLs: the Enterprise WSDL (strongly-typed, specific to the org's schema), the Partner WSDL (loosely-typed, generic across orgs), and the Metadata WSDL (for metadata operations such as deployments and retrievals). The Tooling WSDL is also available for developer tool integrations.

SOAP API supports all standard CRUD operations (create, retrieve, update, upsert, delete, undelete), queries via SOQL and SOSL, metadata describe calls, and utility operations like merge, convertLead, and getUpdated. It is commonly used in enterprise integrations, particularly with Java and .NET platforms. While REST API is preferred for new modern integrations, SOAP API remains widely used in established enterprise environments where Java/.NET tooling provides strong SOAP support.

§ 05

How organizations use SOAP API

Quantum Labs

Uses SOAP API with Enterprise WSDL for strongly-typed Java integrations with their Salesforce data.

TerraForm Tech

Maintains SOAP API integrations for legacy enterprise systems while using REST for new work.

CodeBridge

Trains developers on both APIs, distinguishing when each is appropriate.

§

Trust & references

Official documentation

Straight from the source - Salesforce's reference material on SOAP API.

Was this entry helpful?
Help us write better definitions. Quick reactions or detailed edit suggestions.
§

🧠 Test your knowledge

Q1. What is Salesforce SOAP API?

Q2. What WSDLs are available?

Q3. When use Enterprise vs Partner WSDL?

§

Discussion

Loading…

Loading discussion…