DocumentationJourney OptimizerJourney Optimizer Guide

Configure SMS subdomains

Last update: Wed Apr 16 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Topics:
  • SMS
  • Channel Configuration

CREATED FOR:

  • Intermediate
  • Admin

Get started with SMS subdomains

To be able to shorten URLs added to your SMS/MMS messages, you must set up the subdomain you will select when creating an SMS configuration.

You can either use a subdomain that is already delegated to Adobe, or configure another subdomain. Learn more about delegating subdomains to Adobe in this section.

SMS subdomain configuration is shared between all environments. Therefore, any modification to a SMS subdomain also impacts other production sandboxes.

To access and edit SMS subdomains, you must have the Manage SMS Subdomains permission on the production sandbox. Learn more about permissions in this section.

Use an existing subdomain

To use a subdomain that is already delegated to Adobe, follow the steps below.

  1. Browse to the Administration > Channels menu, and select SMS settings > SMS subdomains.

  2. Click Set up subdomain.

  3. Select Use delegated subdomain from the Configuration type section.

  4. Enter the prefix that will display in your SMS URL.

    Only alpha-numeric characters and hyphens are allowed.

  5. Select a delegated subdomain from the list.

    You cannot select a subdomain that is already used as SMS subdomain.

    CAUTION
    If you select a domain that was delegated to Adobe using the CNAME method, you must create the DNS record on your hosting platform. To generate the DNS record, the process is the same as when you configure a new SMS subdomain. Learn how in this section.

  6. Click Submit.

  7. Once submitted, the subdomain displays in the list with the Processing status. For more on subdomains’ statuses, refer to this section.

    Before being able to use that subdomain to send messages, you must wait until Adobe performs the required checks, which can take up to 4 hours.

  8. Once the checks are successful, the subdomain gets the Success status. It is ready to be used to create SMS channel configurations.

Configure a new subdomain

To configure a new subdomain, follow the steps below.

  1. Browse to the Administration > Channels menu, then select SMS settings > SMS subdomains.

  2. Click Set up subdomain.

  3. Select Add your own domain from the Configuration type section.

  4. Specify the subdomain to delegate.

    CAUTION

    • You cannot use an existing SMS subdomain.

    • Capital letters are not allowed in subdomains.

    Delegating an invalid subdomain to Adobe is not allowed. Make sure you enter a valid subdomain which is owned by your organization, such as marketing.yourcompany.com.

    Multi-level subdomains (of the same parent domain) are supported. For example, you can use ‘sms.marketing.yourcompany.com’.

  5. The record to be placed in your DNS servers displays. Copy this record, or download a CSV file, then navigate to your domain-hosting solution to generate the matching DNS record.

  6. Make sure that DNS record has been generated into your domain-hosting solution. If everything is configured properly, check the box “I confirm…”, then click Submit.

    When you configure a new SMS subdomain, it always points to a CNAME record.

  7. Once the subdomain delegation has been submitted, the subdomain displays in the list with the Processing status. For more on subdomains’ statuses, refer to this section.

Before using a subdomain to send SMS messages, you must wait until Adobe performs the required checks, which can take up to 4 hours. Once the checks are successful, the subdomain gets the Success status. It is ready to be used to create SMS channel configurations.

Note that the subdomain will be marked as Failed if you fail to create the validation record on your hosting solution.

Undelegate a subdomain

If you wish to undelegate an SMS subdomain, contact your Adobe representative.

However, you need to perform several steps in the user interface before reaching out to Adobe.

NOTE
You can only undelegate subdomains with the Success status. Subdomains with the Draft and Failed statuses can simply be deleted from the user interface.

First, perform the following steps in Journey Optimizer:

  1. Deactivate all the channel configurations associated with the subdomain. Learn how

  2. Stop the active campaigns associated with the subdomains. Learn how

  3. Stop the active journeys associated with the subdomains. Learn how

  4. If the SMS subdomain was a new delegated subdomain, remove the DNS entries associated with that subdomain.

Once done, reach out to your Adobe representative with the subdomain you want to undelegate.

After you request is handled by Adobe, the undelegated domain is no longer displayed on the subdomain inventory page.

CAUTION
After a subdomain is undelegated:
  • You cannot reactivate the channel configurations which were using that subdomain.
  • You cannot delegate the exact subdomain again through the user interface. If you want to do so, reach out to your Adobe representative.
recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76