Create MailFolderCreate MailFolder

Espacio de nombres: microsoft.graphNamespace: microsoft.graph

Use esta API para crear un objeto mailfolder secundario.Use this API to create a new child mailfolder.

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) Mail.ReadWriteMail.ReadWrite
Delegado (cuenta personal de Microsoft)Delegated (personal Microsoft account) Mail.ReadWriteMail.ReadWrite
AplicaciónApplication Mail.ReadWriteMail.ReadWrite

Solicitud HTTPHTTP request

POST /me/mailFolders/{id}/childFolders
POST /users/{id | userPrincipalName}/mailFolders/{id}/childFolders

Especifique la carpeta principal en la dirección URL de la consulta como un identificador de carpeta o un nombre de carpeta conocido.Specify the parent folder in the query URL as a folder ID, or a well-known folder name. Para obtener una lista de los nombres de carpetas conocidos compatibles, vea Tipo de recurso mailFolder.For a list of supported well-known folder names, see mailFolder resource type.

Encabezados de solicitudRequest headers

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

Cuerpo de la solicitudRequest body

En el cuerpo de la solicitud, proporcione un objeto JSON con los siguientes parámetros.In the request body, provide a JSON object with the following parameters. displayName es la única propiedad grabable para un objeto mailFolder .displayName is the only writable property for a mailFolder object.

ParámetroParameter TipoType DescripciónDescription
displayNamedisplayName CadenaString Nombre para mostrar de la nueva carpeta.The display name of the new folder.

RespuestaResponse

Si se ejecuta correctamente, este método devuelve 201 Created un código de respuesta y un recurso mailFolder en el cuerpo de la respuesta.If successful, this method returns 201 Created response code and a mailFolder resource 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/mailFolders/{id}/childFolders
Content-type: application/json
Content-length: 159

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

Aquí tiene un ejemplo de la respuesta.Here is an example of the response.

Nota: se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.Note: The response object shown here might be shortened for readability. Se devolverán todas las propiedades de una llamada real.All the properties will be returned from an actual call.

HTTP/1.1 200 OK
Content-type: application/json
Content-length: 179

{
  "displayName": "displayName-value",
  "parentFolderId": "parentFolderId-value",
  "childFolderCount": 99,
  "unreadItemCount": 99,
  "totalItemCount": 99,
  "id": "id-value"
}