Azure Communication Services Email (Preview)

Connector to send Email using the domains linked to the Azure Communication Services in your subscription.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Automate Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Apps Premium All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name Microsoft
URL https://azure.microsoft.com/services/communication-services
Email acssolutions@microsoft.com
Connector Metadata
Publisher Microsoft
Website https://azure.microsoft.com/services/communication-services
Privacy policy https://privacy.microsoft.com
Categories Communication

Azure Communication Services Email is a new primitive that facilitates high volume transactional, bulk and marketing emails on the Azure Communication Services platform and will enable Application-to-Person (A2P) use cases. Azure Communication Services Email offers will improve your time-to-market with scalable, reliable email capabilities with your own SMTP domains. Like other communication modalities Email offering has the benefit of only paying for what you use.

Prerequisites

You will need the following to proceed:

  • A Microsoft Power Apps or Power Automate plan with custom connector feature
  • An Azure subscription
  • An Azure Communication Services Email resource with a configured domain
  • An Azure Communication Services resource connected with an Azure Email domain

How to get credentials

  1. Set up an Azure Communication Services resource

  2. Set up an Azure Commuincation Services Email resource

    1. Create an Email resource
    2. Configure a domain
  3. Connect Email Domain with Communication Services resource

  4. Connection String Authentication

Get started with your connector

After setting up an Azure Communication Services Email resource and configuring a domain, navigate to the provisioned domain, and copy the MailFrom email. This will be used as the From email in the Send email action.

Known issues and limitations

  1. Azure Communication Services Email 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.

  2. Does not support Service principal (Azure AD application) Authentication at this time.

  3. Only these email attachment types are supported.

Common errors and remedies

When attaching unsupported attachments, the Send email action will fail as a BadRequest. Please refer to these email attachment types.

FAQ

  1. Where is my email?

    • Email delivery may take up to a few minutes, and end up in the junk mail box when using Azure Managed domains. Be sure to check your junk mail box.
  2. How do send an email with attachments?

    • Email attachments require both an Attachment Name and Attachment content. Some file hosting services, such as OneDrive and SharePoint, have native support in Power Automate, and they have actions such as Get file metadata to obtain the file name and Get file content to obtain the file content.

Creating a connection

The connector supports the following authentication types:

Default Parameters for creating connection. All regions Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name Type Description Required
Connection String securestring Azure Communication Services Connection String. True

Throttling Limits

Name Calls Renewal Period
API calls per connection10060 seconds

Actions

Get email message status (Preview)

Gets the status of an email message sent previously.

Send email (Preview)

Sends an email message to one or more recipients.

Get email message status (Preview)

Gets the status of an email message sent previously.

Parameters

Name Key Required Type Description
Message ID
messageId True string

Message ID from a previous call to send email.

Returns

Name Path Type Description
Message ID
messageId string
Message Status
status string

Send email (Preview)

Sends an email message to one or more recipients.

Parameters

Name Key Required Type Description
From
sender True string

The sender email address from a verified domain.

Email
email True string

Email address.

Email
email True string

Email address.

Email
email True string

Email address.

Subject
subject True string

Specify the subject of the email.

Body
html html

Specify the body of the email.

Email
email True string

Email address.

Name
name True string

Attachment name with extension.

Content
contentBytesBase64 True byte

Attachment content.

Importance
importance string

The importance type for the email.

Disable User Engagement Tracking
disableUserEngagementTracking boolean

Indicates whether user engagement tracking should be disabled for this request if the resource-level user engagement tracking setting was already enabled in the control plane.