Share via


Azure Communication Email

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 (Microsoft Entra ID 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 connection 100 60 seconds

Actions

Get email message status

Gets the status of an email message sent previously.

Get email message status (Preview) - DEPRECATED [DEPRECATED]

This action has been deprecated. Please use Get email message status instead.

Gets the status of an email message sent previously - DEPRECATED

Send email

Sends an email message to one or more recipients.

Send email (Preview) - DEPRECATED [DEPRECATED]

This action has been deprecated. Please use Send email instead.

Sends an email message to one or more recipients - DEPRECATED

Get email message status

Gets the status of an email message sent previously.

Parameters

Name Key Required Type Description
Operation ID
operationId True string

Operation ID from a previous call to send email.

Returns

Status of the long running operation

Get email message status (Preview) - DEPRECATED [DEPRECATED]

This action has been deprecated. Please use Get email message status instead.

Gets the status of an email message sent previously - DEPRECATED

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

Sends an email message to one or more recipients.

Parameters

Name Key Required Type Description
From
senderAddress True string

The sender email address from a verified domain.11

Importance
importance string
Email (To)
address True string

The email address of main recipient.

Email (CC)
address True string

The email address of additional recipient.

Email (BCC)
address True string

The email address of additional recipient who is invisible in the email chain.

Subject
subject True string

Specify the subject of the email.

Body
html html

Specify the body of the email.

Email (Reply To)
address True string

The email address where recipients' replies will be sent to.

Name
name True string

Attachment name with extension.

Type
contentType True string

The type of attachment file.

Content
contentInBase64 True byte

Attachment content.

name
name True string

Enter key.

value
value True string

Enter value.

Disable User Engagement Tracking
userEngagementTrackingDisabled 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.

Returns

Status of the long running operation

Send email (Preview) - DEPRECATED [DEPRECATED]

This action has been deprecated. Please use Send email instead.

Sends an email message to one or more recipients - DEPRECATED

Parameters

Name Key Required Type Description
From
sender True string

The sender email address from a verified domain.

Email (To)
email True string

The email address of main recipient.

Email (CC)
email True string

The email address of additional recipient.

Email (BCC)
email True string

The email address of additional recipient who is invisible in the email chain.

Subject
subject True string

Specify the subject of the email.

Body
html html

Specify the body of the email.

Email (Reply To)
email True string

The email address where recipients' replies will be sent to.

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.

Definitions

ErrorDetail

The error detail.

Name Path Type Description
code
code string

The error code.

message
message string

The error message.

target
target string

The error target.

details
details array of ErrorDetail

The error details.

additionalInfo
additionalInfo array of ErrorAdditionalInfo

The error additional info.

ErrorAdditionalInfo

The resource management error additional info.

Name Path Type Description
type
type string

The additional info type.

info
info object

The additional info.

EmailSendResult

Status of the long running operation

Name Path Type Description
id
id string

The unique id of the operation. Use a UUID.

status
status string

Status of operation.

error
error ErrorDetail

The error detail.