Azure Communication Messages client library for .NET - version 1.0.0

This package contains a C# SDK for Azure Communication Messages Services.

Source code | Package (NuGet) | Product documentation

Getting started

Install the package

Install the Azure Communication Messages client library for .NET with NuGet:

dotnet add package Azure.Communication.Messages


You need an Azure subscription and a Communication Service Resource to use this package.

To create a new Communication Service, you can use the Azure Portal, the Azure PowerShell, or the .NET management client library.

Key concepts

NotificationMessagesClient provides the functionality to send notification messages .

Using statements

using Azure.Communication.Messages;

Authenticate the client

Connection String

Messages clients can be authenticated using the connection string acquired from an Azure Communication Resource in the Azure Portal.

var connectionString = "<connection_string>"; // Find your Communication Services resource in the Azure portal
NotificationMessagesClient notificationMessagesClient = new NotificationMessagesClient(connectionString);
MessageTemplateClient messageTemplateClient = new MessageTemplateClient(connectionString);


Send an Notification Message

To send a notification message, call the Send or SendAsync function from the NotificationMessagesClient.

Send a text message

// Create the recipient list, currently only one recipient is supported 
var recipient = new List<string> { "<to-phone-number>" };
var textContent = new = new TextNotificationContent(new Guid("<channel-registration-id>"), recipient, "Come on everyone, let's go for lunch together.");
SendMessageResult result = await notificationMessagesClient.SendAsync(textContent);
Console.WriteLine($"Message id: {result.Receipts[0].MessageId}");

Send a template message

// Create the recipient list, currently only one recipient is supported 
var recipient = new List<string> { "<to-phone-number>" };
string templateName = "sample_template";
string templateLanguage = "en_us";
var messageTemplate = new MessageTemplate(templateName, templateLanguage);
var templateContent = new TemplateNotificationContent(channelRegistrationId, recipientList, messageTemplate);
SendMessageResult result = await notificationMessagesClient.SendAsync(templateContent);
Console.WriteLine($"Message id: {result.Receipts[0].MessageId}");

Send a media message

// Create the recipient list, currently only one recipient is supported 
var recipient = new List<string> { "<to-phone-number>" };
var uri = new Uri("");
var mediaContent = new MediaNotificationContent(channelRegistrationId, recipientList, uri);
SendMessageResult result = await notificationMessagesClient.SendAsync(mediaContent);
Console.WriteLine($"Message id: {result.Receipts[0].MessageId}");

Retrieve templates

To retrieve templates, call the GetMessages or GetMessagesAsync function from the MessageTemplateClient.

AsyncPageable<MessageTemplateItem> templates = messageTemplateClient.GetTemplatesAsync(channelId);
await foreach (MessageTemplateItem template in templates)


A RequestFailedException is thrown as a service response for any unsuccessful requests. The exception contains information about what response code was returned from the service.

Next steps

  • Read more about Messages in Azure Communication Services (Link to be added).
  • Read more about how to set up Event Grid subscription for new message and message delivery status (Link to be added).


This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact with any additional questions or comments.