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.
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
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.
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.
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.
When attaching unsupported attachments, the Send email
action will fail as a BadRequest. Please refer to these email attachment types.
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 andGet file content
to 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
The connector supports the following authentication types:
Default | Parameters for creating connection. | All regions | Not shareable |
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 |
Name | Calls | Renewal Period |
---|---|---|
API calls per connection | 100 | 60 seconds |
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.
|
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
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 |
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
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. |
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. |
The resource management error additional info.
Name | Path | Type | Description |
---|---|---|---|
type
|
type | string |
The additional info type. |
info
|
info | object |
The additional info. |
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. |