author | description | ms.date | title | ms.localizationpriority | ms.subservice | doc_type |
---|---|---|---|---|---|---|
spgraph-docs-team |
Create a new listItem in a list. |
09/11/2017 |
Create a new entry in a SharePoint list |
medium |
sharepoint |
apiPageType |
Namespace: microsoft.graph
[!INCLUDE beta-disclaimer]
Create a new listItem in a list.
[!INCLUDE national-cloud-support]
Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions only if your app requires it. For details about delegated and application permissions, see Permission types. To learn more about these permissions, see the permissions reference.
[!INCLUDE permissions-table]
POST /sites/{site-id}/lists/{list-id}/items
In the request body, supply a JSON representation of the listItem resource to create.
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
}
}
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
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.