Create termsAndConditions

Note: Using the Microsoft Graph APIs to configure Intune controls and policies still requires that the Intune service is correctly licensed by the customer.

Create a new termsAndConditions object.

Prerequisites

One of the following scopes is required to execute this API:

DeviceManagementServiceConfiguration.ReadWrite.All

HTTP Request

POST /termsAndConditions/

Request headers

Header Value
Authorization Bearer <token> Required.
Accept application/json

Request body

In the request body, supply a JSON representation of a termsAndConditions object. The following table shows the properties that are required when you create a termsAndConditions.

Property Type Description
id String Unique identifier of the T&C policy.
createdDateTime DateTimeOffset DateTime the object was created.
modifiedDateTime DateTimeOffset DateTime the object was last modified.
displayName String Administrator-supplied name for the T&C policy.
description String Administrator-supplied description of the T&C policy.
title String Administrator-supplied title of the terms and conditions. This is shown to the user on prompts to accept the T&C policy.
bodyText String Administrator-supplied body text of the terms and conditions, typically the terms themselves. This is shown to the user on prompts to accept the T&C policy.
acceptanceStatement String Administrator-supplied explanation of the terms and conditions, typically describing what it means to accept the terms and conditions set out in the T&C policy. This is shown to the user on prompts to accept the T&C policy.
version Int32 Integer indicating the current version of the terms. Incremented when an administrator makes a change to the terms and wishes to require users to re-accept the modified T&C policy.

Response

If successful, this method returns a 201 Created response code and a termsAndConditions object in the response body.

Example

Request

Here is an example of the request.

POST https://graph.microsoft.com/beta/termsAndConditions/
Content-type: application/json
Content-length: 273

{
  "@odata.type": "#microsoft.graph.termsAndConditions",
  "displayName": "Display Name value",
  "description": "Description value",
  "title": "Title value",
  "bodyText": "Body Text value",
  "acceptanceStatement": "Acceptance Statement value",
  "version": 7
}

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: 441

{
  "@odata.type": "#microsoft.graph.termsAndConditions",
  "id": "eefc80cf-80cf-eefc-cf80-fceecf80fcee",
  "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
  "modifiedDateTime": "2017-01-01T00:00:22.8983556-08:00",
  "displayName": "Display Name value",
  "description": "Description value",
  "title": "Title value",
  "bodyText": "Body Text value",
  "acceptanceStatement": "Acceptance Statement value",
  "version": 7
}