Skip to main content
Documentation
Documentation
Administrator Guide
Last Updated: 2025-04-18
Steps: Set Up Customer-Provided Receiving Domains

Steps: Set Up Customer-Provided Receiving Domains

Identify the names of the subdomains that you want to use before setting up your customer-provided receiving domains.
You need to configure a customer-provided receiving domain for email ingestion only if you don’t use the Workday-provided receiving domain. Workday recommends that you use the Workday-provided receiving domain to save time and reduce complexity.
You can create multiple customer-provided email ingestion receiving domains per tenant, but you must use a unique subdomain for each receiving domain across your tenants. Example: If you create a receiving domain of Help.GMS.com in your Preview tenant, you can't use Help.GMS.com in your Production tenant.
To enhance security, all emails sent to an email ingestion receiving domain require at least one valid DomainKeys Identified Mail signature.
Workday recommends that you work with your IT administrator to set up your customer-provided receiving domains.
  1. Access the
    Create Email Ingestion Receiving Domain
     task.
    If you want to use the customer-provided receiving domains in Production that you set up in your pre-migration tenant, you must run the
    Fix Email Ingestion Receiving Domain Configuration
     task in your Production tenant so that they are available to you.
    1. Enter the subdomain and domain that you want to use for your receiving domain. Example: When your subdomain is Help and your domain is GMS.com, your email ingestion receiving domain is Help.GMS.com. When creating a new receiving domain:
      • Work with your IT administrator to identify the subdomain and domain.
      • Don't use an existing subdomain and domain combination.
      • Configure only 1 subdomain and domain combination for each notification type.
      • Workday recommends that you create more than 1 subdomain and domain combination for testing in different tenants at the same time.
    2. Click
      Refresh
       to display the canonical names (CNAMEs) and mail exchange (MX) values that you need for your DNS provider configuration on the
      View Email Ingestion Receiving Domain
       report.
    Security:
    Set Up: Inbound Email
     domain in the System functional area
  2. Update your DNS provider configuration with your new email ingestion receiving domain values.
    Work with your IT administrator to add these values on the View Email Ingestion Receiving Domain report to your DNS provider configuration. It can take up to 48 hours for DNS updates to take effect.
    • The 3 CNAME values in the DNS Records grid.
    • The MX record values in the MX Record grid.
  3. Access the
    Verify Email Ingestion Receiving Domain
     task.
    1. Select your receiving domain.
    2. Click
      OK
       and then click
      Refresh
       to see if your receiving domain verification is successful.
    If you're unable to successfully verify your email ingestion receiving domain, confirm that the changes to your DNS host completed successfully.
    Security:
    Set Up: Inbound Email
     domain in the System functional area.
After you successfully verify your customer-provided receiving domain, you can configure it for different notification types. See Configure Email Ingestion Settings.