開発者向け機能：API：メール：メール送信
## 概要
[メール送信API](/ja/manual/faq-sendmail-with-attachments)を使用するとメールを送信できます。
なお、送信元メールアドレスはユーザのメールアドレス、または[Mail.json](/ja/manual/mail.json)のFixedFromまたはSupportFromを適切に設定する必要があります。
## 注意事項
バージョン1.5.0.0以降のプリザンターで添付ファイルが破損する不具合がありました。当該の不具合はバージョン1.5.3.0で修正されております。添付ファイル付きメール送信機能を使用する場合は、バージョン1.5.0.0から1.5.2.0のプリザンターを使用しないでください。
## 事前準備
APIの操作を行う前に[APIキーの作成](/manual/api-key)を実施してください。
## リクエスト
下記のリクエスト形式で、JSONデータを送信します。
|設定項目|値|
|:--|:--|
|HTTPメソッド|POST|
|Content-Type |application/json|
|文字コード|UTF-8|
|URL|http://{サーバー名}/api/items/{レコードID}/OutgoingMails/Send (※1)|
|Body|以下のJSONデータを参考のこと|
(※1){サーバー名},{レコードID}の部分は、適宜、環境に合わせて編集してください。
pleasanter.netの場合は以下の形式になります。
https\://pleasanter.net/fs/api/items/{レコードID}/OutgoingMails/Send
・JSONデータの必須項目
|項目|必須|備考|
|:--|:--|:--|
|ApiVersion|〇||
|ApiKey|〇||
|To|-||
|Cc|-||
|Bcc|-||
|Title|〇||
|Body|-||
|Attachments|-|以下のプロパティを設定してください。<br>Name : ファイル名<br>Base64 : 添付ファイルをBase64エンコードした文字列<br>ContentType : コンテンツタイプ|
##### JSON
```
{
"ApiVersion": 1.1,
"ApiKey": "[設定したAPIキー]",
"To": "[受信側メールアドレス]",
"Cc": "[受信側Ccメールアドレス]",
"Bcc": "[受信側Bccメールアドレス]",
"Title": "メール送信APIのテストです",
"Body": "メール送信APIのテストでメールを送信します。",
"Attachments": [
{
"Name": "sample1.txt",
"Base64": "c2FtcGxlMS50eHQ=...",
"ContentType": "text/plain"
},
{
"Name": "sample2.txt",
"Base64": "c2FtcGxlMi50eHQ=...",
"ContentType": "text/plain"
}
]
}
```
## レスポンス
下記の形式のJSONデータが返却され、メールが送信されます。
##### JSON
```
{
"Id": <レコードID>,
"StatusCode": 200,
"Message": "メールを送信しました。"
}
```
## 参考：PostmanによるHTTPリクエスト送信
※content-typeはヘッダー（Headers）で設定しています。
## 対応バージョン
|対応バージョン|内容|
|:--|:--|
|1.2.4.0 以降|Attachmentsを追加|
|1.5.7.0 以降|未使用のプロパティ（From）を削除|
## エラー時の確認事項
[・API使用時の注意点やエラーが発生する場合の確認事項](/manual/faq-api)
[・FAQ:変更後の設定ファイルやAPIリクエスト(JSON形式)が正しく認識されない場合の確認事項](/manual/faq-json-format)
## 関連情報
<div id="ManualList"><ul><li><a href="/ja/manual/mail.json">パラメータ設定：Mail.json</a><span>2026/07/14 up</span></li></ul></article>
<ul><li><a href="/ja/manual/faq-sendmail-with-attachments">FAQ：編集画面から添付ファイル付きのメールを送信したい</a><span>2026/08/17 up</span></li></ul></article></div><input id="SearchTextHidden" type="hidden" value="" />
