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 |
| 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
Set up an Azure Commuincation Services Email resource
- Create an Email resource
- Configure a domain
Connect Email Domain with Communication Services resource
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 (Microsoft Entra ID 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 metadatato obtain the file name andGet file contentto obtain the file content.
- 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
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.
|
| 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.
|
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
- Body
- EmailSendResult
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
- Body
- EmailSendResult
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)
|
True | string |
The email address of main recipient. |
|
|
Email (CC)
|
True | string |
The email address of additional recipient. |
|
|
Email (BCC)
|
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)
|
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. |