Tenant-Specific API Endpoints

Marketing Cloud Engagement 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 a 28-character string that begins with the letters mc. When your subdomain is appended to API endpoints, it creates endpoints that are unique to your tenant. For security and performance reasons, you must use your tenant-specific endpoint to interact with the APIs.

For example, Northern Trail Outfitters’ tenant has the subdomain mc563885gzs27c5t9-63k636ttgm. The endpoint that they use depends on which API they want to interact with.

  • To use REST API, they use the endpoint mc563885gzs27c5t9-63k636ttgm.rest.marketingcloudapis.com.
  • To use SOAP API, they use the endpoint mc563885gzs27c5t9-63k636ttgm.soap.marketingcloudapis.com.

Locate your tenant’s endpoints and use them in your API requests. Only your tenant can use your endpoints.

You can use your tenant-specific subdomain only with the marketingcloudapis.com domain. You can’t use the exacttargetapis.com or exacttarget.com domains.

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.

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.