Your Subdomain and Your Tenant's Endpoints
As part of our ongoing commitment to customer trust and security, integrations into Marketing Cloud are now required to utilize tenant-specific endpoints by September 30, 2022.
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. Use these endpoints to improve the performance of your API requests.
For example, Northern Trail Outfitters’ tenant has this subdomain: mc563885gzs27c5t9-63k636ttgm. These are their endpoints:
- REST API endpoint: mc563885gzs27c5t9-63k636ttgm.rest.marketingcloudapis.com
- SOAP API endpoint: mc563885gzs27c5t9-63k636ttgm.soap.marketingcloudapis.com
Locate your tenant’s endpoints, which contain your subdomain, in Marketing Cloud and use them in your API requests. Only your tenant can use your endpoints. No other Marketing Cloud customer can use them for their API requests.
You can use your subdomain only with the marketingcloudapis.com endpoint structure. You can’t use exacttargetapis.com or exacttarget.com with your subdomain to create your tenant’s endpoints.
API Integrations with an Access Token
For SOAP and REST API integrations that use access tokens for authorization, locate your tenant’s SOAP, REST, and Authentication Base URIs on the API Integration component of packages created in Installed Packages.
API Integrations with a Username and Password
For SOAP API integrations that use a username and password for authentication, locate your tenant’s SOAP WSDL and SOAP Service Endpoint either under Account Settings in Setup or under User Settings in Cloud Preferences. API User must be enabled.