mailFolder: importMime

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Cree un mensaje que no sea de borrador en una carpeta de correo directamente a partir de contenido MIME, sin enviarlo a transporte.

A diferencia de la creación de un mensaje, que siempre crea un borrador, esta acción crea el mensaje en un estado final, no de borrador. El mensaje aparece en la carpeta de destino como si se hubiera entregado; sin embargo, no pasa por el transporte, no se marca como enviado y nunca aparece en la carpeta Elementos enviados . La acción conserva todo el contenido MIME, incluidos los encabezados de los mensajes de Internet, las partes del cuerpo y los datos adjuntos.

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use uno o varios permisos con privilegios más altos solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso	Permisos con privilegios mínimos	Permisos con privilegios más altos
Delegado (cuenta profesional o educativa)	Correo electrónico avanzado.Lectura y escritura	No disponible.
Delegado (cuenta personal de Microsoft)	No admitida.	No admitida.
Aplicación	Mail-Advanced.ReadWrite.All	No disponible.

Solicitud HTTP

POST /me/mailFolders/{mailFolderId}/importMime
POST /users/{usersId}/mailFolders/{mailFolderId}/importMime

Nota: Puede {mailFolderId} ser un id. de carpeta o un nombre de carpeta conocido, como inbox.

Encabezados de solicitud

Nombre	Descripción
Authorization	{token} de portador. Obligatorio. Obtenga más información sobre autenticación y autorización.
Content-Type	text/plain. Obligatorio.

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione el contenido MIME del mensaje. Proporcione los encabezados de mensaje de Internet aplicables y el contenido MIME, todo codificado en base64.

Todo el cuerpo de la solicitud es el contenido MIME codificado en Base64, sin sobre ni parámetros JSON. Esta API no admite la edición ni la actualización de propiedades MIME individualmente.

Respuesta

Si se realiza correctamente, esta acción devuelve un 201 Created código de respuesta y un objeto de mensaje en el cuerpo de la respuesta. El mensaje devuelto tiene isDraft establecido en false.

Si el cuerpo de la solicitud incluye contenido MIME incorrecto, esta acción devuelve un 400 Bad Request código de respuesta y el siguiente mensaje de error: Invalid base64 string for MIME content.

Ejemplos

Solicitud

En el ejemplo siguiente se muestra la solicitud. El cuerpo de la solicitud es el contenido MIME codificado en Base64, abreviado por legibilidad.

POST https://graph.microsoft.com/beta/me/mailFolders/inbox/importMime
Content-type: text/plain

RnJvbTogY29udG9zby1hbGVydHNAY29udG9zby5jb20NClRvOiB0ZXN0aW5nQGNvbnRvc28uY29t
DQpTdWJqZWN0OiBRdWFydGVybHkgcmVwb3J0DQpEYXRlOiBUaHUsIDI1IEp1biAyMDI2IDEwOjAw
OjAwIC0wNzAwDQpDb250ZW50LVR5cGU6IHRleHQvcGxhaW47IGNoYXJzZXQ9InV0Zi04Ig0KDQpC
b2R5IG9mIHRoZSBpbXBvcnRlZCBtZXNzYWdlLg==

Respuesta

En el ejemplo siguiente se muestra la respuesta.

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

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

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#users('02d1914d-7abd-4621-a407-57b8bdeb1ada')/messages/$entity",
  "id": "AAMkADE5MWM0YmM5LThjOWUtNGFhZi1hOTBhLWNmZDBiZDhhNTljMABGAAAA",
  "createdDateTime": "2026-09-17T21:30:19Z",
  "lastModifiedDateTime": "2026-09-17T21:30:20Z",
  "receivedDateTime": "2026-09-17T21:30:20Z",
  "sentDateTime": "2026-07-24T20:03:00Z",
  "hasAttachments": false,
  "subject": "Quarterly report",
  "isRead": false,
  "isDraft": false,
  "parentFolderId": "AAMkADE5MWM0YmM5LThjOWUtNGFhZi1hOTBhLWNmZDBiZDhhNTljMAAuAAAA"
}