Azure Communication Services Email (Preview)

Reference

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

Set up an Azure Communication Services resource
- Quickstart doc
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
Connect Email Domain with Communication Services resource
- Quickstart doc
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

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.
Does not support Service principal (Azure AD application) Authentication at this time.
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

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.
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 (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)

Operation ID:: GetMessageStatus

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)

Operation ID:: SendEmail

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.