Share via


Azure Communication Services SMS

Connector to send SMS using the phone numbers from 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 acs_telco_messaging@microsoft.com
Connector Metadata
Publisher Microsoft
Website https://azure.microsoft.com/services/communication-services
Privacy policy https://privacy.microsoft.com
Categories Communication

Creating a connection

The connector supports the following authentication types:

ConnectionString Authentication Use your connection string to access your Azure Communication Service resource. All regions Shareable
Service principal (Microsoft Entra ID application) Authentication Use Microsoft Entra ID Authentication to access your Azure Communication Service resource. All regions Not shareable
Default [DEPRECATED] This option is only for older connections without an explicit authentication type, and is only provided for backward compatibility. All regions Not shareable

ConnectionString Authentication

Auth ID: connectionStringAuthentication

Applicable: All regions

Use your connection string to access your Azure Communication Service resource.

This is shareable connection. If the power app is shared with another user, connection is shared as well. For more information, please see the Connectors overview for canvas apps - Power Apps | Microsoft Docs

Name Type Description Required
Connection String securestring Azure Communication Services Connection String True

Service principal (Microsoft Entra ID application) Authentication

Auth ID: aadAuthentication

Applicable: All regions

Use Microsoft Entra ID Authentication to access your Azure Communication Service resource.

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
Tenant ID string Tenant ID of your Microsoft Entra ID application. True
Client ID string Client (or Application) ID of your Microsoft Entra ID application. True
Client Secret securestring Client secret of your Microsoft Entra ID application. True
ACS Endpoint URL string Your ACS resource endpoint URL. True

Default [DEPRECATED]

Applicable: All regions

This option is only for older connections without an explicit authentication type, and is only provided for backward compatibility.

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 1000 60 seconds

Actions

Send SMS

Sends SMS using the phone numbers in your Azure Communication Services

Send SMS (deprecated) [DEPRECATED]

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

Sends SMS using the phone numbers in your Azure Communication Services (deprecated)

Send SMS

Sends SMS using the phone numbers in your Azure Communication Services

Parameters

Name Key Required Type Description
From Phone Number
from True string

Phone number from your Azure Communication Services

To
to True string

The recipient's phone number in E.164 format.

Message
message True string

Message to be sent

DeliveryReport
enableDeliveryReport boolean

Delivery receipts are sent over event subscriptions in your Azure Communication Services

Tag
tag string

Custom Tag. It will be sent back in the Delivery Report.

Returns

Name Path Type Description
value
value array of object
to
value.to string

The recipient's phone number in E.164 format.

messageId
value.messageId string

The identifier of the outgoing Sms message. Only present if message processed.

httpStatusCode
value.httpStatusCode integer

HTTP Status code.

repeatabilityResult
value.repeatabilityResult string

The result of a repeatable request with one of the case-insensitive values accepted or rejected.

successful
value.successful boolean

Indicates if the message is processed successfully or not.

errorMessage
value.errorMessage string

Optional error message in case of 4xx/5xx/repeatable errors.

Send SMS (deprecated) [DEPRECATED]

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

Sends SMS using the phone numbers in your Azure Communication Services (deprecated)

Parameters

Name Key Required Type Description
From Phone Number
from string

Phone number from your Azure Communication Services

To
to array of string

Valid phone number +(countryCode)(phoneNumber)

Message
message string

Message to be sent

DeliveryReport
enableDeliveryReport boolean

Delivery receipts are sent over event subscriptions in your Azure Communication Services

Returns

Name Path Type Description
messageId
messageId string

Unique identifier for the message sent