Quickstart: How to add Azure Managed Domains to Email Communication Service

Important

This feature of Azure Communication Services is currently in preview.

Preview APIs and SDKs are provided without a service-level agreement. We recommend that you don't use them for production workloads. Some features might not be supported, or they might have constrained capabilities.

For more information, review Supplemental Terms of Use for Microsoft Azure Previews.

In this quick start, you'll learn about how to provision the Azure Managed domain in Azure Communication Services to send email.

Prerequisites

Provision Azure Managed Domain

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

  2. Create the Azure Managed Domain.

    • (Option 1) Click the 1-click add button under Add a free Azure subdomain. Move to the next step.

    Screenshot that highlights the adding a free Azure Managed Domain.

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

    Screenshot that shows the Provision Domains navigation page.

    • Click Add domain on the upper navigation bar.
    • Select Azure domain from the dropdown.
  3. Wait for the deployment to complete.

    Screenshot that shows the Deployment Progress.

  4. After domain creation is completed, you'll see a list view with the created domain.

    Screenshot that shows the list of provisioned email domains.

  5. Click the name of the provisioned domain. This will navigate you to the overview page for the domain resource type.

    Screenshot that shows Azure Managed Domain overview page.

Sender authentication for Azure Managed Domain

Azure communication Services Email automatically configures the required email authentication protocols to set proper authentication for the email as detailed in Email Authentication best practices.

Changing MailFrom and FROM display name for Azure Managed Domain

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 Azure Manged Domain link

    Screenshot that shows Azure Managed Domain link in list of provisioned email domains.

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

    Screenshot that shows the overview page of provisioned email domain.

  5. Click on edit link on MailFrom

    Screenshot that explains how to change Mail From address and display name for an email address.

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

    Screenshot that shows the submit button to save Mail From address and display name changes.

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

    Screenshot that shows Azure Managed Domain overview page with updated values.

Your email domain is now ready to send emails.

Next steps

The following documents may be interesting to you: