Loading

Marketing Cloud Engagement - Update SOAP API Integrations to Utilize Your Tenant’s Endpoints

게시 일자: Jan 28, 2025
상세 설명

What is happening?

Salesforce is built from the ground up to protect your data and applications. As part of our ongoing commitment to customer trust and security, integrations into Marketing Cloud are recommended to utilize tenant-specific endpoints for improved stability and scalability
 

What is a tenant-specific endpoint?

Marketing Cloud automatically assigns a unique, system-generated subdomain to each of its tenants. A tenant represents your top-level Enterprise account and its business units, your Core account, your top-level Agency account, or your Client account, depending on your tenant type. Your subdomain is represented by a 28-character string starting with the letters "mc". When your subdomain is appended to Marketing Cloud APIs, it creates endpoints that are unique to your tenant.
 

Who is impacted?

Customers utilizing Email Studio, Mobile Studio, Automation Studio, or Audience Builder and executing SOAP API requests may be impacted.
 

How do I determine if my SOAP API integrations need to be updated?

Your SOAP API integrations will need to be updated if one of the following endpoints are being utilized:
  • https://webservice.exacttarget.com
  • https://webservice.s4.exacttarget.com
  • https://webservice.s6.exacttarget.com
  • https://webservice.s7.exacttarget.com
  • https://webservice.s10.exacttarget.com
  • https://webservice-auth.exacttarget.com
  • https://webservice-sha2.exacttarget.com
  • https://webservice-test.exacttarget.com
  • https://webservice-tls.exacttarget.com

Where can I find out more?

For updates, questions and resources, please follows the Marketing Cloud API Endpoint Updates group on the Salesforce Trailblazer community 

솔루션

Where do I find my tenant’s SOAP API endpoints?

  1. Your tenant’s SOAP API URI can be found in Installed Packages under Setup> Platform Tools> Apps> Installed Packages. Inside Installed Packages, you must
    1. To build your tenant’s SOAP WSDL endpoint, append: /etframework.wsdl
    2. To build your tenant’s SOAP Service endpoint, append: /Service.asmx
  2. Your tenant’s SOAP WSDL and SOAP Service Endpoint can can also be found under Setup > Company Settings > Account Settings.
  3. Additionally, you can navigate to your Cloud Preferences > User Settings and find your tenant’s SOAP WSDL URL and SOAP Service Endpoint if API User is “Yes”.
 

How do I update my SOAP WSDL and Service Endpoint?

After locating your tenant’s SOAP WSDL and Service endpoint, update your Marketing Cloud integrations by replacing any existing endpoints with the appropriate tenant endpoint.

Example Request with updated tenant-specific Service Endpoint

POST /Service.asmx HTTP/1.1
Host: mclf6n1asf8FAKEwy4p4r86k0b31.soap.marketingcloudapis.com

Content-Type: text/xml
Cache-Control: no-cache

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:wsa="http://schemas.xmlsoap.org/ws/2004/08/addressing" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
<soap:Header>
<wsa:Action>GetSystemStatus</wsa:Action>
<wsa:To>https://mclf6n1asf8FAKEwy4p4r86k0b31.soap.marketingcloudapis.com/Service.asmx</wsa:To>
<wsse:Security soap:mustUnderstand="1">
<wsse:UsernameToken
xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" wsu:Id="SecurityToken-db1066a9-acf1-4f1b-a455-12e721913742">
<wsse:Username>XXXX</wsse:Username>
<wsse:Password
Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">XXXX</wsse:Password>
</wsse:UsernameToken>
</wsse:Security>
</soap:Header>
<soap:Body>
<SystemStatusRequestMsg xmlns="http://exacttarget.com/wsdl/partnerAPI" />
</soap:Body>
</soap:Envelope>
 

 

Knowledge 기사 번호

000392834

 
로드 중
Salesforce Help | Article