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.
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.
In plain English
“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.”
Worked example
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.
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.
How organizations use SOAP API
Uses SOAP API with Enterprise WSDL for strongly-typed Java integrations with their Salesforce data.
Maintains SOAP API integrations for legacy enterprise systems while using REST for new work.
Trains developers on both APIs, distinguishing when each is appropriate.
Trust & references
Straight from the source - Salesforce's reference material on SOAP API.
- About SOAP APISalesforce Developers
- Quick Start: SOAP APISalesforce Developers
🧠 Test your knowledge
Q1. What is Salesforce SOAP API?
Q2. What WSDLs are available?
Q3. When use Enterprise vs Partner WSDL?

Discussion
Loading discussion…