Azure Communication Services Identity

Connector to create and manage users and access tokens in an Azure Communication Services resource.

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 Identity is used for managing users and user tokens for Azure Communication Services.

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 resource

How to get credentials

After setting up your Azure Communication Services resource (with this quickstart doc), obtain the connection credentials by accessing your connection string.

Get started with your connector

After setting up an Azure Communication Services resource, you can use this connector to generate user IDs and refresh access tokens.

Known issues and limitations

Does not support Service Principal (Microsoft Entra ID application) Authentication at this time.

Common errors and remedies

No known common errors.

FAQ

1. Why does my access token not work?
   • Your access token may have expired, please try issuing a new access token.

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

Create a user	Create a new user, and optionally, an access token.
Delete a user	Delete the user, revoke all access tokens for the user and delete all associated data.
Issue a user access token	Issue a new access token for the user.
Revoke user access tokens	Revoke all access tokens for the user.

Create a user

Operation ID:

CreateCommunicationIdentity

Create a new user, and optionally, an access token.

Parameters

Name	Key	Required	Type	Description
Token Scopes	Token Scopes		string

Returns

Name	Path	Type	Description
User ID	identity.id	string
accessToken	accessToken	accessToken

Delete a user

Operation ID:

DeleteCommunicationIdentity

Delete the user, revoke all access tokens for the user and delete all associated data.

Parameters

Name	Key	Required	Type	Description
User ID	identityId	True	string	Azure Communication Services user ID.

Issue a user access token

Operation ID:

IssueIdentityAccessToken

Issue a new access token for the user.

Parameters

Name	Key	Required	Type	Description
User ID	identityId	True	string	Azure Communication Services user ID.
Token Scopes	Token Scopes		string

Returns

Body

accessToken

Revoke user access tokens

Operation ID:

RevokeIdentityAccessTokens

Revoke all access tokens for the user.

Parameters

Name	Key	Required	Type	Description
User ID	identityId	True	string	Azure Communication Services user ID.

Definitions

accessToken

Name	Path	Type	Description
Access Token	token	string
Token Expiry	expiresOn	date-time