Create ContactFolderCreate ContactFolder

Espacio de nombres: microsoft.graphNamespace: microsoft.graph

Crea una contactFolder en la carpeta predeterminada de contactos del usuario.Create a new contactFolder under the user's default contacts folder.

También se puede crear una contactfolder como elemento secundario de cualquier carpeta de contacto especificada.You can also create a new contactfolder as a child of any specified contact folder.

PermisosPermissions

Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permisoPermission type Permisos (de menos a más privilegiados)Permissions (from least to most privileged)
Delegado (cuenta profesional o educativa)Delegated (work or school account) Contacts.ReadWriteContacts.ReadWrite
Delegado (cuenta personal de Microsoft)Delegated (personal Microsoft account) Contacts.ReadWriteContacts.ReadWrite
AplicaciónApplication Contacts.ReadWriteContacts.ReadWrite

Solicitud HTTPHTTP request

POST /me/contactFolders
POST /users/{id | userPrincipalName}/contactFolders

Encabezados de solicitudRequest headers

EncabezadoHeader ValorValue
AuthorizationAuthorization {token} de portador. Obligatorio.Bearer {token}. Required.
Content-TypeContent-Type application/jsonapplication/json

Cuerpo de la solicitudRequest body

En el cuerpo de la solicitud, proporcione una representación JSON del objeto ContactFolder.In the request body, supply a JSON representation of ContactFolder object.

RespuestaResponse

Si se ejecuta correctamente, este método devuelve el código de respuesta 201 Created y el objeto ContactFolder en el cuerpo de la respuesta.If successful, this method returns 201 Created response code and ContactFolder object in the response body.

EjemploExample

SolicitudRequest

Aquí tiene un ejemplo de la solicitud.Here is an example of the request.

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

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

En el cuerpo de la solicitud, proporcione una representación JSON del objeto contactFolder.In the request body, supply a JSON representation of contactFolder object.

RespuestaResponse

Aquí tiene un ejemplo de la respuesta. Nota: Puede que el objeto de respuesta que aparece aquí se trunque para abreviar. Todas las propiedades se devolverán de una llamada real.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: 104

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