Azure Communication Services SMS Events (Preview)

Connector to receive SMS messages from the Azure Communication Services resources 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

The Azure Communication Services SMS Events connector enables the processing of SMS messages sent to Azure Communication Services phone numbers.

Prerequisites

You will need the following to proceed:

• A Microsoft Power Apps or Power Automate plan with custom connector feature
• An Azure subscription with the Event Grid resource provider registered
• An Azure Communication Services resource
• An Azure Communication Services purchased phone number that is set up to receive SMS messages

How to get credentials

1. Create an Azure Communication Services resource - Quickstart doc.

2. Purchase a phone number in this resource with the "Send and receive SMS" feature selected.

3. Register an Event Grid resource provider for the subscription the Azure Communication Services resource is contained in.

4. Create an Microsoft Entra ID user or Service Principal that can be used for the connector connection.

   • Option 1: Connection using Microsoft Entra ID account - Add a new user
   • Option 2: Connection using Service Principal (Microsoft Entra ID application) Authentication - You can also set up a service principal, create a registered application from the Azure CLI or through the Azure portal. The credentials can then be used to authenticate.

5. Ensure the Microsoft Entra ID user or service principal has the following permissions assigned to them:

   • Microsoft.Communication/CommunicationServices/Read

   • Microsoft.Resources/subscriptions/resourceGroups/read

   • Microsoft.EventGrid/eventSubscriptions/write

   • Microsoft.EventGrid/eventSubscriptions/read

   • Microsoft.EventGrid/eventSubscriptions/delete

     This can be achieved by creating a custom role or assigning the user to the following built-in roles:

   • Reader - At the Azure Communication Services resource level

   • EventGrid EventSubscription Contributor - At the resource group level

Get started with your connector

This connector contains a single trigger When an SMS message is received. By default it will run when a message is sent to any of your purchased phone numbers, but it can also be configured to only run based on the "To" and "From" phone numbers of the SMS message.

Known issues and limitations

• Trigger temporarily disabled on update if "Event Subscription Name" set - If a value was assigned to the "Event Subscription Name" field when creating the trigger, any updates to the trigger (for example, adding a "To" phone number) can take up to 10 minutes to be applied. During this time the trigger will not function.
• Event Subscription not deleted if Connection deleted before Flow.

Creating a connection

The connector supports the following authentication types:

Microsoft Entra ID Integrated	Use Microsoft Entra ID to access ACS event resources.	All regions	Not 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

Microsoft Entra ID Integrated

Auth ID: aadOauth

Applicable: All regions

Use Microsoft Entra ID to access ACS event resources.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Service principal (Microsoft Entra ID application) Authentication

Auth ID: aadOauthClientCredentials

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

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.

Throttling Limits

Name	Calls	Renewal Period
API calls per connection	100	60 seconds

Triggers

When an SMS message is received

When an Azure Communication Services SMS message is received.

When an SMS message is received

Operation ID:

CreateSMSReceivedEventSubscription

When an Azure Communication Services SMS message is received.

Parameters

Name	Key	Required	Type	Description
Subscription	subscriptionId	True	string	The unique identifier for the Microsoft Azure subscription. The subscription ID forms part of the ID for every Azure resource.
Resource Group Name	resourceGroupName	True	string	The name of the resource group containing your resource.
Resource Name	resourceName	True	string	The name of the Communication Services resource.
Filter By To Phone Number	toPhoneNumbers		array of string
Filter By From Phone Number	fromPhoneNumbers		array of string
Event Subscription Name	eventSubscriptionName		string	The name for the new event subscription.
includedEventTypes	includedEventTypes	True	array of string

Returns

Name	Path	Type	Description
		array of object
To	data.to	string
From	data.from	string
Message	data.message	string
Received Timestamp	data.receivedTimestamp	string
Message ID	data.messageId	string