ContactFolder erstellen

Erstellt einen neuen contactFolder unter dem Standardkontaktordner des Benutzers.

Sie können auch einen neuen contactfolder als untergeordnetes Element eines angegebenen Kontaktordners erstellen.

Voraussetzungen

Einer der folgenden Bereiche ist erforderlich, um diese API auszuführen: Contacts.ReadWrite

HTTP-Anforderung

POST /users/{id | userPrincipalName}/contactFolders

Anforderungsheader

Kopfzeile Wert
Authorization Bearer . Required.
Content-Type application/json

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung des ContactFolder-Objekts an.

Antwort

Wenn die Methode erfolgreich verläuft, werden der Antwortcode 201, Created und das ContactFolder-Objekt im Antworttext zurückgegeben.

Beispiel

Anforderung

Nachfolgend sehen Sie ein Beispiel der Anforderung.

POST https://graph.microsoft.com/v1.0/me/contactFolders
Content-type: application/json
Content-length: 84

{
  "parentFolderId": "parentFolderId-value",
  "displayName": "displayName-value"
}

Geben Sie im Anforderungstext eine JSON-Darstellung des contactFolder-Objekts an.

Antwort

Nachfolgend sehen Sie ein Beispiel der Antwort. Hinweis: Das hier gezeigte Antwortobjekt ist möglicherweise aus Platzgründen abgeschnitten. Von einem tatsächlichen Aufruf werden alle Eigenschaften zurückgegeben.

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

{
  "parentFolderId": "parentFolderId-value",
  "displayName": "displayName-value",
  "id": "id-value"
}