Envoyer un messageSend mail

Envoie le message spécifié dans le corps de la requête. Le message est enregistré dans le dossier des éléments envoyés par défaut.Send the message specified in the request body. The message is saved in the Sent Items folder by default.

Vous pouvez inclure une pièce jointe dans le même appel de l’action sendMail.You can include a file attachment in the same sendMail action call.

AutorisationsPermissions

L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Type d’autorisationPermission type Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)Permissions (from least to most privileged)
Déléguée (compte professionnel ou scolaire)Delegated (work or school account) Mail.SendMail.Send
Déléguée (compte Microsoft personnel)Delegated (personal Microsoft account) Mail.SendMail.Send
ApplicationApplication Mail.SendMail.Send

Requête HTTPHTTP request

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

En-têtes de demandeRequest headers

En-têteHeader ValeurValue
AutorisationAuthorization Porteur {token}. Obligatoire.Bearer {token}. Required.
Content-TypeContent-Type application/jsonapplication/json

Corps de la demandeRequest body

Dans le corps de la demande, indiquez un objet JSON avec les paramètres suivants.In the request body, provide a JSON object with the following parameters.

ParamètreParameter TypeType DescriptionDescription
messagemessage MessageMessage Le message à envoyer. Obligatoire.The message to send. Required.
saveToSentItemssaveToSentItems BooleanBoolean Indique s’il faut enregistrer le message dans les éléments envoyés. Spécifiez uniquement si le paramètre est false ; la valeur par défaut est true. Facultatif.Indicates whether to save the message in Sent Items. Specify it only if the parameter is false; default is true. Optional.

RéponseResponse

Si elle réussit, cette méthode renvoie un code de réponse 202 Accepted. Elle ne renvoie rien dans le corps de la réponse.If successful, this method returns 202 Accepted response code. It does not return anything in the response body.

ExempleExample

Voici comment vous pouvez appeler cette API.Here is an example of how to call this API.

Demande 1Request 1

Voici un exemple de demande.Here is an example of the request.

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

{
  "message": {
    "subject": "Meet for lunch?",
    "body": {
      "contentType": "Text",
      "content": "The new cafeteria is open."
    },
    "toRecipients": [
      {
        "emailAddress": {
          "address": "fannyd@contoso.onmicrosoft.com"
        }
      }
    ],
    "ccRecipients": [
      {
        "emailAddress": {
          "address": "danas@contoso.onmicrosoft.com"
        }
      }
    ]
  },
  "saveToSentItems": "false"
}
Réponse 1Response 1

Voici un exemple de réponse.Here is an example of the response.

HTTP/1.1 202 Accepted
Demande 2Request 2

L’exemple suivant crée un message avec des en-têtes de message Internet personnalisés et envoie le message.The next example creates a message with custom Internet message headers and sends the message.

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

{
  "message": {
    "subject": "9/9/2018: concert",
    "body": {
      "contentType": "HTML",
      "content": "The group represents Nevada."
    },
    "toRecipients": [
      {
        "emailAddress": {
          "address": "AlexW@contoso.OnMicrosoft.com"
        }
      }
    ],
    "internetMessageHeaders":[
      {
        "name":"x-custom-header-group-name",
        "value":"Nevada"
      },
      {
        "name":"x-custom-header-group-id",
        "value":"NV001"
      }
    ]
  }
}
Réponse 2Response 2

Voici un exemple de réponse.Here is an example of the response.

HTTP/1.1 202 Accepted