---
sourceDocument: オーストラリア API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/api-reference

 Release :

    - australia

ft:locale :

    - ja-JP

ft:publication_title :

    - オーストラリア API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# メール API

# メール API {#ariaid-title1}

* リリースバージョン: Australia
* 
* 更新日 2026年08月07日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：12分

メール API は、REST を使用してメールメッセージを送受信できるようにするエンドポイントを提供します。{#email-api__release-notes-feature-description}
ユーザーにメールを送信するには、email_api_sendロールが必要です。  
注:  
メール \[sys_email\] テーブルへの読み取り/書き込みアクセス権がない場合は、エラーが発生する可能性があります。

## メール:GET /now/email/{id} {#ariaid-title2}

指定されたメールレコードのメールの詳細を返します。

### URL 形式 {#email-GET__section_kdx_pzs_cmb}

バージョニングされた URL: /api/now/{api_version}/email/{id}  
注:  
使用可能なバージョン [は、REST API エクスプローラー](https://servicenow-prod.fluidtopics.net/5V9lEGssZWUBc2ao1C_~Fg "このチュートリアルでは、REST API エクスプローラーを使用して、 ServiceNow REST API をテストします。")で指定されます。スクリプト済み REST API の場合、\[ [スクリプト済み REST サービス\] フォーム](I8AGM_146DeZDBTS~H_J8g "スクリプト化された REST API 機能を使用すると、アプリケーション開発者はカスタム Web サービス API をビルドできます。")に追加のバージョン情報があります。

### サポートされている要求パラメーター

{#email-GET__entry__2}{#email-GET__version-not_optional-RESTAPI}

| 名前 | 説明 |
|-|-|
| api_version | オプション。アクセスするエンドポイントのバージョン。たとえば、 <kbd class="ph userinput">v1</kbd> や <kbd class="ph userinput">v2</kbd> などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 |
| ID | 詳細を返すメールのSys_id。 データタイプ：文字列 テーブル:メール \[sys_email\] |
[表 : 1. パスパラメーター]

{#email-GET__entry__8}

| 名前 | 説明 |
|-|-|
| sysparm_fields | 応答で返すフィールドのカンマ区切りリスト。 データタイプ：文字列 |
[表 : 2. クエリパラメーター]

{#email-GET__entry__12}

| 名前 | 説明 |
|-|-|
| なし |   |
[表 : 3. 要求本文パラメーター (XML または JSON)]

### ヘッダー

次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。
{#email-GET__entry__16}{#email-GET__accept-RESTAPI}

| ヘッダー | 説明 |
|-|-|
| 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json |
[表 : 4. 要求ヘッダー]

{#email-GET__entry__20}

| ヘッダー | 説明 |
|-|-|
| なし |   |
[表 : 5. 応答ヘッダー]

### ステータスコード

この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。
{#email-GET__entry__24}{#email-GET__entry-200-status-code}{#email-GET__entry-401-status-code}{#email-GET__entry-500-status-code}

| ステータスコード | 説明 |
|-|-|
| 200 | 成功。要求が正常に処理されました。 |
| 401 | 権限がありません。ユーザー認証情報が正しくないか、渡されていません。 |
| 403 | レコードが見つからないか、要求ユーザーにレコードへのアクセス権がないことを示します。ユーザーに適切なロールとアクセス権限があることを確認します。 |
| 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 |
[表 : 6. ステータスコード]

### 応答本文のパラメーター (JSON または XML)

{#email-GET__entry__34}

| 要素 | 説明 |
|-|-|
| BCC | メールメッセージのブラインドコピー受信者のメールアドレスのリスト。blind_copiedフィールドにマッピングします。 データタイプ：アレイ |
| cc | メールメッセージのコピー受信者のメールアドレスのリスト。コピーされたフィールドにマップします。 データタイプ：アレイ |
| ヘッダー | メッセージに関連付けられたヘッダーとその値の名前と値のペア。 データタイプ: オブジェクト |
| html | HTML 対応のメールメッセージ本文。本文フィールドにマップします。 データタイプ：文字列 |
| ID | メールレコードのSys_id。 データタイプ：文字列 |
| importance | メールメッセージの重要性。重要性フィールドにマップします。 データタイプ：文字列 |
| 状況 | メールメッセージの処理ステータス。システムスケジュール済みジョブがメールメッセージを処理したかどうかを示します。 可能なものは次のとおりです。 * エラー * 無視 * 処理済み * ready {#email-GET__ul_l1x_dp2_zw} データタイプ：文字列 |
| 件名 | メールメッセージの件名。対象フィールドにマップします。 データタイプ：文字列 |
| テキスト | メールメッセージのテキストのみの本文。body_textフィールドにマッピングします。 データタイプ：文字列 |
| 次へ | メールメッセージの直接受信者のメールアドレスのリスト。受信者フィールドにマップします。 データタイプ：アレイ |
| type | メールメッセージの現在のステータス (受信メールまたは送信メール)。 可能な値： * 受信 * received-ignored * 送信失敗 * 送信無視 * 送信-準備完了 * 送信 {#email-GET__ul_z3k_n42_zw} データタイプ：文字列 |
[ ]

### cURL 要求のサンプル

    curl "http://instance.servicenow.com/api/now/email/06e095427f0022007f005212bdfa91b3" \
    --request GET \
    --header "Accept:application/json" \
    --user "user-name":"password"

    {
      "result" : {
        "headers" : {
          "X-ServiceNow-SysEmail-Version" : "2",
          "X-ServiceNow-Source" : "Notification-24e34b54c61122aa0108c1b7a33697cf"
        },
        "cc" : [
          ""
        ],
        "type" : "send-ready",
        "html" : "<html><head></head><body><div><p><font size=\"5\" color=\"#808080\" face=\"helvetica\"><strong>Incident has been closed.</strong></font></p></div>\n\t\t<div><p><font size=\"4\" color=\"#808080\" face=\"helvetica\"><strong>Summary details</strong></font></p><p><font size=\"3\" color=\"#808080\" face=\"helvetica\">Closed by: System Administrator</font></p><p><font size=\"3\" color=\"#808080\" face=\"helvetica\">Closed notes: Fixed</font></p></div>\n\t\t<div><p><font size=\"3\" color=\"#808080\" face=\"helvetica\">You can view all the details of the incident by following the link below:</font></p><font face=\"helvetica\"><a href=\"incident.do?sys_id=e8e875b0c0a80164009dc852b4d677d5&amp;sysparm_stack=incident_list.do?sysparm_query=active=true\" style=\"background-color: #278efc;border: 1px solid #0368d4;color: #ffffff;font-size: 16px;font-family: Helvetica, Arial, sans-serif;text-decoration: none; border-radius: 3px;-webkit-border-radius: 3px;-moz-border-radius: 3px;display: inline-block;padding: 5px;\">Take me to the Incident</a></font><br /><br /><p><font size=\"3\" color=\"#808080\" face=\"helvetica\">Thank you.</font></p></div><div> </div><div style=\"display:inline\">Ref:MSG0000006</div></body></html>",
        "bcc" : [
          ""
        ],
        "subject" : "Your incident INC0000005 has been closed",
        "to" : [
          "alejandro.mascall@example.com"
        ],
        "state" : "ready",
        "id" : "06e095427f0022007f005212bdfa91b3",
        "importance" : "",
        "text" : ""
      }
    }

## メール:POST /now/email {#ariaid-title3}

渡された情報を使用してメールレコードを作成します。

### URL 形式 {#email-POST__section_urw_jpt_cmb}

バージョニングされた URL: /api/now/{api_version}/email  
注:  
使用可能なバージョン [は、REST API エクスプローラー](https://servicenow-prod.fluidtopics.net/5V9lEGssZWUBc2ao1C_~Fg "このチュートリアルでは、REST API エクスプローラーを使用して、 ServiceNow REST API をテストします。")で指定されます。スクリプト済み REST API の場合、\[ [スクリプト済み REST サービス\] フォーム](I8AGM_146DeZDBTS~H_J8g "スクリプト化された REST API 機能を使用すると、アプリケーション開発者はカスタム Web サービス API をビルドできます。")に追加のバージョン情報があります。

### サポートされている要求パラメーター

{#email-POST__entry__2}{#email-POST__version-not_optional-RESTAPI}

| 名前 | 説明 |
|-|-|
| api_version | オプション。アクセスするエンドポイントのバージョン。たとえば、 <kbd class="ph userinput">v1</kbd> や <kbd class="ph userinput">v2</kbd> などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 |
[表 : 7. パスパラメーター]

{#email-POST__entry__6}

| 名前 | 説明 |
|-|-|
| なし |   |
[表 : 8. クエリパラメーター]

{#email-POST__entry__10}

| 要素 | 説明 |
|-|-|
| BCC | メールメッセージのブラインドコピー受信者のメールアドレスのリスト。blind_copiedフィールドにマッピングします。 注: このフィールドには最大 100 個のアドレスしか指定できません。 データタイプ：アレイ |
| cc | メールメッセージのコピー受信者のメールアドレスのリスト。コピーされたフィールドにマップします。 注: このフィールドには最大 100 個のアドレスしか指定できません。 データタイプ：アレイ |
| ヘッダー | メッセージに関連付けられたヘッダーとその値の名前と値のペア。 データタイプ: オブジェクト |
| html | HTML 対応のメールメッセージ本文。本文フィールドにマップします。 データタイプ：文字列 |
| importance | メールメッセージの重要性。重要性フィールドにマップします。 データタイプ：文字列 |
| 件名 | メールメッセージの件名。対象フィールドにマップします。 データタイプ：文字列 |
| table_name | メールを保存するテーブルの名前。このパラメーターを使用して、システム内の他の場所にある特定の関連レコードにメールメッセージを関連付けます。 注: このパラメーターでは、 table_record_id パラメーターを指定する必要もあります。 データタイプ：文字列 |
| table_record_id | メールが適用されるターゲット関連レコード。このパラメーターを使用して、システム内の他の場所にある特定の関連レコードにメールメッセージを関連付けます。 注: このパラメーターでは、 table_name パラメーターを指定する必要もあります。 データタイプ：文字列 |
| テキスト | メールメッセージのテキストのみの本文。body_textフィールドにマッピングします。 データタイプ：文字列 |
| 次へ | 必須です。メールメッセージの直接受信者のメールアドレスのリスト。受信者フィールドにマップします。 注: このフィールドには最大 100 個のアドレスしか指定できません。 データタイプ：アレイ |
[表 : 9. 要求本文パラメーター (XML または JSON)]

### ヘッダー

次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。
{#email-POST__entry__32}{#email-POST__accept-RESTAPI}{#email-POST__content_type-RESTAPI}

| ヘッダー | 説明 |
|-|-|
| 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json |
| Content-Type | 要求本文のデータ形式。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json |
[表 : 10. 要求ヘッダー]

{#email-POST__entry__38}

| ヘッダー | 説明 |
|-|-|
| なし |   |
[表 : 11. 応答ヘッダー]

### ステータスコード

この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。
{#email-POST__entry__42}{#email-POST__entry-200-status-code}{#email-POST__entry-400-status-code}{#email-POST__entry-401-status-code}{#email-POST__entry-500-status-code}

| ステータスコード | 説明 |
|-|-|
| 200 | 成功。要求が正常に処理されました。 |
| 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 |
| 401 | 権限がありません。ユーザー認証情報が正しくないか、渡されていません。 |
| 403 | 要求ユーザーにはレコードへのアクセス権がありません。ユーザーに適切なロールとアクセス権限があることを確認します。 |
| 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 |
[表 : 12. ステータスコード]

### 応答本文のパラメーター (JSON または XML)

{#email-POST__entry__54}

| 要素 | 説明 |
|-|-|
| href | メール API GET 要求としてメールレコードにリンクします。 データタイプ：文字列 |
| ID | メールレコードのSys_id。 データタイプ：文字列 |
| リンク | メールレコードへのリンクのリスト。 データタイプ：アレイ |
| 関係 | hrefパラメーターにリストされているリンクのタイプ。 可能な値： * self:メールレコードに対するメール API GET 要求。 * status:ID、タイプ、ステータス、およびエラーの各フィールドのみを表示するメールレコードに対するメール API GET 要求。 {#email-POST__ul_gwp_rrt_cmb} データタイプ：文字列 |
[ ]

### cURL 要求のサンプル

    curl "http://instance.servicenow.com/api/now/email" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --user 'username':'password'\
    --data "{
      \"to\": [
        \"User1 <user1@example.com>\",
        \"User2 <user2@example.com>\"
      ],
      \"cc\": [
        \"User3 <user3@example.com>\",
        \"User4 <user4@example.com>\"
      ],
      \"bcc\": [
        \"User5 <user5@example.com>\",
        \"User6 <user6@example.com>\"
      ],
      \"subject\": \"Hello There\",
      \"text\": \"Test Message\",
      \"html\": \"<b>Test Message</b>\",
      \"table_name\": \"incident\",
      \"table_record_id\": \"136b2140bd0312004d7d1371f1abbdb6\",
      \"headers\": {
        \"X-Custom\": \"header\"
      }
    }"

    {
     "result": {
       "id": "b963219a44b02200964f63773cd6adfc",
       "links": [
         {
           "rel": "self",
           "href": "/now/v1/email/b963219a44b02200964f63773cd6adfc"
         },
         {
           "rel": "status",
           "href": "/now/v1/email/b963219a44b02200964f63773cd6adfc?sysparm_fields=id,type,state,error"
         }
       ]
     }
    }