Create MailFolderCreate MailFolder

Espacio de nombres: microsoft.graphNamespace: microsoft.graph

Usa esta API para crear una carpeta de correo en la carpeta raíz del buzón del usuario.Use this API to create a new mail folder in the root folder of the user's mailbox.

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
POST /users/{id | userPrincipalName}/mailFolders

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 un objeto JSON con los siguientes parámetros. displayName es la única propiedad que se puede escribir de un objeto MailFolder.In the request body, provide a JSON object with the following parameters. 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 el código de respuesta 201 Created y un objeto MailFolder en el cuerpo de la respuesta.If successful, this method returns 201 Created response code and a MailFolder 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/mailFolders
Content-type: application/json
Content-length: 159

{
  "displayName": "displayName-value"
}
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: 179

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