Skip to main content
Documentation
Documentation
Administrator Guide
Last Updated: 2024-03-08
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 name 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.
All emails sent to an email ingestion receiving domain require at least one valid DomainKeys Identified Mail signature.
  1. Access the
    Create Email Ingestion Receiving Domain
     task.
    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.
    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.
      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.