メールを送信する

要求本文に指定されたメッセージを送信します。メッセージは、既定で [送信済みアイテム] フォルダーに保存されます。

添付ファイル を同じ sendMail アクション呼び出しに含めることができます。

前提条件

この API を実行するには、以下のいずれかのスコープが必要です。Mail.Send

HTTP 要求

POST /users/{id | userPrincipalName}/sendMail

要求ヘッダー

ヘッダー
Authorization Bearer . Required.
Content-Type application/json

要求本文

要求本文で、次のパラメーターを含む JSON オブジェクトを指定します。

パラメーター 説明
Message Message 送信するメッセージです。必須。
SaveToSentItems Boolean [送信済みアイテム] 内のメッセージを保存するかどうかを示します。パラメーターを false にする場合にのみ指定します。既定では true です。省略可能。

応答

成功した場合、このメソッドは 202, Accepted 応答コードを返します。応答本文には何も返されません。

以下は、この API を呼び出す方法の例です。

要求

以下は、要求の例です。

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

{
  "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"
}
応答

以下は、応答の例です。

HTTP/1.1 202 Accepted