Create a new item in a list

Important: APIs under the /beta version in Microsoft Graph are in preview and are subject to change. Use of these APIs in production applications is not supported.

Create a new listItem in a list.

Prerequisites

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

  • Sites.ReadWrite.All

HTTP request

POST https://graph.microsoft.com/beta/sites/{site-id}/lists/{list-id}/items

Request body

In the request body, supply a JSON representation of the listItem resource to create.

Example

Here is an example of how to create a new generic list item.

POST https://graph.microsoft.com/beta/sites/{site-id}/lists/{list-id}/items
Content-Type: application/json

{
  "fields": {
    "Title": "Widget",
    "Color": "Purple",
    "Weight": 32
  }
}

Response

If successful, this method returns a listItem in the response body for the created list item.

HTTP/1.1 201 Created
Content-type: application/json

{
  "id": "20",
  "createdDateTime": "2016-08-30T08:26:00Z",
  "createdBy": {
    "user": {
      "displayName": "Ryan Gregg",
      "id": "8606e4d5-d582-4f5f-aeba-7d7c18b20cfd"
    }
  },
  "lastModifiedDateTime": "2016-08-30T08:26:00Z",
  "lastModifiedBy": {
    "user": {
      "displayName": "Ryan Gregg",
      "id": "8606e4d5-d582-4f5f-aeba-7d7c18b20cfd"
    }
  }
}

Note: The response object is truncated for clarity. Default properties will be returned from the actual call.