Namespace: microsoft.graph
Note: The Microsoft Graph API for Intune requires an active Intune license for the tenant.
Create a new localizedNotificationMessage object.
This API is available in the following national cloud deployments.
| Global service |
US Government L4 |
US Government L5 (DOD) |
China operated by 21Vianet |
| ✅ |
✅ |
✅ |
✅ |
Permissions
One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.
| Permission type |
Permissions (from least to most privileged) |
| Delegated (work or school account) |
DeviceManagementServiceConfig.ReadWrite.All |
| Delegated (personal Microsoft account) |
Not supported. |
| Application |
DeviceManagementServiceConfig.ReadWrite.All |
HTTP Request
POST /deviceManagement/notificationMessageTemplates/{notificationMessageTemplateId}/localizedNotificationMessages
Request body
In the request body, supply a JSON representation for the localizedNotificationMessage object.
The following table shows the properties that are required when you create the localizedNotificationMessage.
| Property |
Type |
Description |
| id |
String |
Key of the entity. |
| lastModifiedDateTime |
DateTimeOffset |
DateTime the object was last modified. |
| locale |
String |
The Locale for which this message is destined. |
| subject |
String |
The Message Template Subject. |
| messageTemplate |
String |
The Message Template content. |
| isDefault |
Boolean |
Flag to indicate whether or not this is the default locale for language fallback. This flag can only be set. To unset, set this property to true on another Localized Notification Message. |
Response
If successful, this method returns a 201 Created response code and a localizedNotificationMessage object in the response body.
Example
Request
Here is an example of the request.
POST https://graph.microsoft.com/v1.0/deviceManagement/notificationMessageTemplates/{notificationMessageTemplateId}/localizedNotificationMessages
Content-type: application/json
Content-length: 200
{
"@odata.type": "#microsoft.graph.localizedNotificationMessage",
"locale": "Locale value",
"subject": "Subject value",
"messageTemplate": "Message Template value",
"isDefault": true
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Models;
var requestBody = new LocalizedNotificationMessage
{
OdataType = "#microsoft.graph.localizedNotificationMessage",
Locale = "Locale value",
Subject = "Subject value",
MessageTemplate = "Message Template value",
IsDefault = true,
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.DeviceManagement.NotificationMessageTemplates["{notificationMessageTemplate-id}"].LocalizedNotificationMessages.PostAsync(requestBody);
For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation.
mgc device-management notification-message-templates localized-notification-messages create --notification-message-template-id {notificationMessageTemplate-id} --body '{\
"@odata.type": "#microsoft.graph.localizedNotificationMessage",\
"locale": "Locale value",\
"subject": "Subject value",\
"messageTemplate": "Message Template value",\
"isDefault": true\
}\
'
For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation.
// Code snippets are only available for the latest major version. Current major version is $v1.*
// Dependencies
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
graphmodels "github.com/microsoftgraph/msgraph-sdk-go/models"
//other-imports
)
requestBody := graphmodels.NewLocalizedNotificationMessage()
locale := "Locale value"
requestBody.SetLocale(&locale)
subject := "Subject value"
requestBody.SetSubject(&subject)
messageTemplate := "Message Template value"
requestBody.SetMessageTemplate(&messageTemplate)
isDefault := true
requestBody.SetIsDefault(&isDefault)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
localizedNotificationMessages, err := graphClient.DeviceManagement().NotificationMessageTemplates().ByNotificationMessageTemplateId("notificationMessageTemplate-id").LocalizedNotificationMessages().Post(context.Background(), requestBody, nil)
For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation.
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
LocalizedNotificationMessage localizedNotificationMessage = new LocalizedNotificationMessage();
localizedNotificationMessage.setOdataType("#microsoft.graph.localizedNotificationMessage");
localizedNotificationMessage.setLocale("Locale value");
localizedNotificationMessage.setSubject("Subject value");
localizedNotificationMessage.setMessageTemplate("Message Template value");
localizedNotificationMessage.setIsDefault(true);
LocalizedNotificationMessage result = graphClient.deviceManagement().notificationMessageTemplates().byNotificationMessageTemplateId("{notificationMessageTemplate-id}").localizedNotificationMessages().post(localizedNotificationMessage);
For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation.
const options = {
authProvider,
};
const client = Client.init(options);
const localizedNotificationMessage = {
'@odata.type': '#microsoft.graph.localizedNotificationMessage',
locale: 'Locale value',
subject: 'Subject value',
messageTemplate: 'Message Template value',
isDefault: true
};
await client.api('/deviceManagement/notificationMessageTemplates/{notificationMessageTemplateId}/localizedNotificationMessages')
.post(localizedNotificationMessage);
For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation.
<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\LocalizedNotificationMessage;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new LocalizedNotificationMessage();
$requestBody->setOdataType('#microsoft.graph.localizedNotificationMessage');
$requestBody->setLocale('Locale value');
$requestBody->setSubject('Subject value');
$requestBody->setMessageTemplate('Message Template value');
$requestBody->setIsDefault(true);
$result = $graphServiceClient->deviceManagement()->notificationMessageTemplates()->byNotificationMessageTemplateId('notificationMessageTemplate-id')->localizedNotificationMessages()->post($requestBody)->wait();
For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation.
Import-Module Microsoft.Graph.DeviceManagement
$params = @{
"@odata.type" = "#microsoft.graph.localizedNotificationMessage"
locale = "Locale value"
subject = "Subject value"
messageTemplate = "Message Template value"
isDefault = $true
}
New-MgDeviceManagementNotificationMessageTemplateLocalizedNotificationMessage -NotificationMessageTemplateId $notificationMessageTemplateId -BodyParameter $params
For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation.
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.models.localized_notification_message import LocalizedNotificationMessage
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = LocalizedNotificationMessage(
odata_type = "#microsoft.graph.localizedNotificationMessage",
locale = "Locale value",
subject = "Subject value",
message_template = "Message Template value",
is_default = True,
)
result = await graph_client.device_management.notification_message_templates.by_notification_message_template_id('notificationMessageTemplate-id').localized_notification_messages.post(request_body)
For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation.
Response
Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 313
{
"@odata.type": "#microsoft.graph.localizedNotificationMessage",
"id": "7a777708-7708-7a77-0877-777a0877777a",
"lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
"locale": "Locale value",
"subject": "Subject value",
"messageTemplate": "Message Template value",
"isDefault": true
}