Quickstart: How to add custom verified domains to Email Communication Service

Important

This feature of Azure Communication Services is currently in public preview. Preview APIs and SDKs are provided without a service-level agreement, and are not recommended for production workloads. Certain features might not be supported or might have constrained capabilities. For more information, see Supplemental Terms of Use for Microsoft Azure Previews.

In this quick start, you'll learn about how to add a custom domain and verify in Azure Communication Services to send email.

Prerequisites

Provision custom domain

To provision a custom domain you need to

  • Verify the custom domain ownership by adding TXT record in your DNS.
  • Configure the sender authentication by adding SPF and DKIM records.

Verify custom domain

  1. Go the overview page of the Email Communications Service resource that you created earlier.

  2. Setup Custom Domain.

    • (Option 1) Click the Setup button under Setup a custom domain. Move to the next step.

      Screenshot that shows how to setup a custom domain.

    • (Option 2) Click Provision Domains on the left navigation panel.

      Screenshot that shows the navigation link to Provision Domains page.

    • Click Add domain on the upper navigation bar.

    • Select Custom domain from the dropdown.

  3. You'll be navigating to "Add a custom Domain".

  4. Enter your "Domain Name" and re enter domain name.

  5. Click Confirm

    Screenshot that shows where to enter the custom domain value.

  6. Ensure that domain name isn't misspelled or click edit to correct the domain name and confirm.

  7. Click Add

    Screenshot that shows how to add a custom domain of your choice.

  8. This will create custom domain configuration for your domain.

    Screenshot that shows the progress of custom domain Deployment.

  9. You can verify the ownership of the domain by clicking Verify Domain

    Screenshot that shows that custom domain is successfully added for verification. .

  10. If you would like to resume the verification later, you can click Close and resume the verification from Provision Domains by clicking Configure .

    Screenshot that shows the added domain ready for verification in the list of provisioned domains.

  11. Clicking Verify Domain or Configure will navigate to "Verify Domain via TXT record" to follow.

    Screenshot that shows the Configure link that you need to click to verify domain ownership.

  12. You need add the above TXT record to your domain's registrar or DNS hosting provider. Click Next once you've completed this step.

  13. Verify that TXT record is created successfully in your DNS and Click Done

  14. DNS changes will take up to 15 to 30 minutes. Click Close

    Screenshot that shows the domain verification is in progress.

  15. Once your domain is verified, you can add your SPF and DKIM records to authenticate your domains.

    Screenshot that shows the the custom domain is verified.

Configure sender authentication for custom domain

  1. Navigate to Provision Domains and confirm that Domain Status is in "Verified" state.

  2. You can add SPF and DKIM by clicking Configure. You need add the following TXT record and CNAME records to your domain's registrar or DNS hosting provider. Click Next once you've completed this step.

    Screenshot that shows the D N S records that you need to add for S P F validation for your verified domains.

    Screenshot that shows the D N S records that you need to add for D K I M.

    Screenshot that shows the D N S records that you need to add for additional D K I M records.

  3. Verify that TXT and CNAME records are created successfully in your DNS and Click Done

    Screenshot that shows the DNS records that you need to add for S P F and D K I M.

  4. DNS changes will take up to 15 to 30 minutes. Click Close

    Screenshot that shows that the sender authentication verification is in progress.

  5. Wait for Verification to complete. You can check the verification status from Provision Domains page.

    Screenshot that shows that the sender authentication verification is done.

  6. Once your sender authentication configurations are successfully verified, your email domain will be ready to send emails using custom domain.

    Screenshot that shows that your verified custom domain is ready to send Email.

Changing MailFrom and FROM display name for custom domains

When Azure Manged Domain is provisioned to send mail, it has default Mail from address as donotreply@xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.azurecomm.net and the FROM display name would be the same. You'll able to configure and change the Mail from address and FROM display name to more user friendly value.

  1. Go the overview page of the Email Communications Service resource that you created earlier.

  2. Click Provision Domains on the left navigation panel. You'll see list of provisioned domains.

  3. Click on the Custom Domain name that you would like to update.

    Screenshot that shows how to get to overview page for verified Custom Domain from provisioned domains list.

  4. The navigation lands in Domain Overview page where you'll able to see Mailfrom and From attributes.

    Screenshot that shows the overview page of the verified custom domain.

  5. Click on edit link on MailFrom

    Screenshot that shows how to edit Mail From and display name for custom domain email address.

  6. You'll able to modify the Display Name and MailFrom address.

    Screenshot that shows that how to modify the Mail From and display name values.

  7. Click Save. You'll see the updated values in the overview page.

    Screenshot that shows that how to save the modified values of Mail From and display name.

Your email domain is now ready to send emails.

Next steps

The following documents may be interesting to you: