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

   • Quickstart doc

2. Set up an Azure Commuincation Services Email resource

   1. Create an Email resource
      • Quickstart doc
   2. Configure a domain
      • Add Azure Managed domains
      • OR Add custom domains

3. Connect Email Domain with Communication Services resource

   • Quickstart doc

4. Connection String Authentication

   • You can create a new connection using an Azure Communication Services resource connection string.

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

Operation ID:

GetMessageStatusGAVersion

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

Body

EmailSendResult

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

Operation ID:

GetMessageStatus

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

Operation ID:

SendEmailGAVersion

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

Body

EmailSendResult

Send email (Preview) - DEPRECATED [DEPRECATED]

Operation ID:

SendEmail

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.