---
sourceDocument: Xanadu API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/api-reference
Release :
- xanadu
ft:locale :
- ja-JP
ft:publication_title :
- Xanadu API リファレンス
ft:clusterId :
- crapiref
bundleId :
- crapiref
workflow :
- Creator
---
# 連絡先 API
# 連絡先 API {#ariaid-title1}
* リリースバージョン: Xanadu
*
* 更新日 2024年08月01日
*
*  所要時間：44分
連絡先 API は、カスタマーサービス管理 (CSM) 連絡先レコードの取得と更新を可能にするエンドポイントを提供します。
さらに、連絡先の作成時に新しいソーシャルメディアプロファイルレコードを生成できます。
連絡先 API にはカスタマーサービスプラグイン (com.sn_customerservice) が必要であり、`now` 名前空間内で提供されます。
ユーザーが API にフルアクセスするためには、csm_ws_integration ロールが必要です。
## 連絡先 - GET /now/contact {#ariaid-title2}
指定された カスタマーサービス管理 (CSM) 連絡先セットを取得します。
### URL 形式
バージョニングされた URL：/api/now/{api_version}/contact
デフォルトの URL：/api/now/contact
### サポートされている要求パラメーター
{#contact-GET__entry__2}{#contact-GET__version-RESTAPI}
| 名前 | 説明 |
|-|-|
| api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 |
[表 : 1. パスパラメーター]
{#contact-GET__entry__6}{#contact-GET__sysparm-limit-entry}{#contact-GET__sysparm-offset-entry}{#contact-GET__sysparm-query-entry}
| 名前 | 説明 |
|-|-|
| sysparm_limit | 返されるレコードの最大数。このレコード数を超える要求の場合は、sysparm_offset パラメーターを使用してレコード取得をページネーションします。 応答では、ブール値のパラメーター hasMore が返されます。フィルター基準を満たす、返されるレコードがまだあるかどうかを示します。 データタイプ：数値 デフォルト：10 |
| sysparm_offset | レコード取得を開始するレコードのインデックス。この値を使用して、レコード取得をページネーションします。この機能により、レコード数に関係なく、管理しやすい小さなチャンクに分割してすべてのレコードを取得できます。 たとえば、このエンドポイントを初めて呼び出すときに、sysparm_offset は「0」に設定されます。単に利用可能なすべてのレコードをページングするには、すべてのレコードの終わりに達するまで「`sysparm_offset=sysparm_offset+sysparm_limit`」を使用します。 sysparm_offset パラメーターには負数を指定しないでください。 データタイプ：数値 デフォルト：0 |
| sysparm_query | 結果セットのフィルタリングに使用されるエンコードされたクエリ。 例： `sysparm_query=caller_id=javascript:gs.getUserID()^active=true` エンコードされたクエリは、 順序 をサポートしています。特定のフィールドに基づいて回答を並べ替えるには、ORDERBY と ORDERBYDESC の句を sysparm_query で使用します。たとえば、`sysparm_query=active=true^ORDERBYnumber^ORDERBYDESCcategory` はすべてのアクティブなレコードをフィルタリングし、最初に番号によって昇順に、次にカテゴリによって降順に結果を並び替えます。 フィールド名が無効というようにクエリの一部が無効であると、インスタンスは無効な部分を無視します。次に、クエリの有効部分のみを使用して行を返します。この動作は glide.invalid_query.returns_no_rows プロパティを使用してコントロールできます。無効なクエリに行を返さないようにするには、このプロパティを true に設定します。 注: glide.invalid_query.returns_no_rows プロパティは、リスト、スクリプト (GlideRecord.query())、Web サービス API など、インスタンスのすべてのクエリの動作を管理します。 データタイプ：文字列 |
[表 : 2. クエリパラメーター]
{#contact-GET__entry__14}
| 名前 | 説明 |
|-|-|
| なし | |
[表 : 3. 要求本文パラメーター (XML または JSON)]
### ヘッダー
次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。
{#contact-GET__entry__18}{#contact-GET__accept-RESTAPI}
| ヘッダー | 説明 |
|-|-|
| 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json |
[表 : 4. 要求ヘッダー]
{#contact-GET__entry__22}
| ヘッダー | 説明 |
|-|-|
| なし | |
[表 : 5. 応答ヘッダー]
### ステータスコード
この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。
{#contact-GET__entry__26}{#contact-GET__entry-200-status-code}{#contact-GET__entry-500-status-code}{#contact-GET__d2755e810}
| ステータスコード | 説明 |
|-|-|
| 200 | 成功。要求が正常に処理されました。 |
| 500 | 内部サーバーエラー。要求の処理中に予期しないエラーが発生しました。応答に、エラーに関する追加情報が含まれます。 |
| 500 | 内部サーバーエラー。要求の処理中に予期しないエラーが発生しました。応答に、エラーに関する追加情報が含まれます。 |
[表 : 6. ステータスコード]
### 応答本文のパラメーター (JSON または XML)
エンドポイントでは、次の JSON または XML 要素を応答本文で返すことができます。以下で定義する (ベースシステムにある要素を定義する) 要素のリストに加えて、エンドポイントでは、連絡先 \[customer_contact\] テーブルに追加されたカスタムフィールドも返します。これらの要素の詳細については、特定のテーブル定義 \[システム定義テーブル\].
{#contact-GET__csmcontact_response_parms__entry__2}{#contact-GET__contacttable-account-enrty}{#contact-GET__contacttable-active-entry}{#contact-GET__contacttable-agent_status-entry}{#contact-GET__contacttable-building-entry}{#contact-GET__contacttable-calendar_integration-entry}{#contact-GET__contacttable-city-entry}{#contact-GET__contacttable-company-entry}{#contact-GET__contacttable-cost_center-entry}{#contact-GET__contacttable-country-entry}{#contact-GET__contacttable-date_format-entry}{#contact-GET__contacttable-default_perspective-entry}{#contact-GET__contacttable-department-entry}{#contact-GET__contacttable-edu_status-entry}{#contact-GET__contacttable-email-entry}{#contact-GET__contacttable-employee_number-entry}{#contact-GET__contacttable-enable_multifactor_authn-entry}{#contact-GET__contacttable-failed_attempts-entry}{#contact-GET__contacttable-first_name-entry}{#contact-GET__contacttable-gender-entry}{#contact-GET__contacttable-geolocation_tracked-entry}{#contact-GET__contacttable-home_phone-entry}{#contact-GET__contacttable-internal_integration_user-entry}{#contact-GET__contacttable-introduction-entry}{#contact-GET__contacttable-last_login-entry}{#contact-GET__contacttable-last_login_device-entry}{#contact-GET__contacttable-last_login_time-entry}{#contact-GET__contacttable-last_name-entry}{#contact-GET__contacttable-last_position_update-entry}{#contact-GET__contacttable-latitude-entry}{#contact-GET__contacttable-ldap_server-entry}{#contact-GET__contacttable-location-entry}{#contact-GET__contacttable-locked_out-entry}{#contact-GET__contacttable-longitude-entry}{#contact-GET__contacttable-manager-entry}{#contact-GET__contacttable-middle_name-entry}{#contact-GET__contacttable-mobile_phone-entry}{#contact-GET__contacttable-name-entry}{#contact-GET__contacttable-notification-entry}{#contact-GET__contacttable-on_schedule-entry}{#contact-GET__contacttable-phone-entry}{#contact-GET__contacttable-photo-entry}{#contact-GET__contacttable-preferred_language-entry}{#contact-GET__contacttable-roles-entry}{#contact-GET__contacttable-schedule-entry}{#contact-GET__contacttable-source-entry}{#contact-GET__contacttable-state-entry}{#contact-GET__contacttable-street-entry}{#contact-GET__contacttable-sys_class_name-entry}{#contact-GET__contacttable-sys_created_by-entry}{#contact-GET__contacttable-sys_created_on-entry}{#contact-GET__contacttable-sys_domain-entry}{#contact-GET__contacttable-sys_domain_path-entry}{#contact-GET__contacttable-sys_id-entry}{#contact-GET__contacttable-sys_mod_count-entry}{#contact-GET__contacttable-sys_updated_by-entry}{#contact-GET__contacttable-sys_updated_on-entry}{#contact-GET__contacttable-time_format-entry}{#contact-GET__contacttable-time_sheet_policy-entry}{#contact-GET__contacttable-time_zone-entry}{#contact-GET__contacttable-title-entry}{#contact-GET__contacttable-user_name-entry}{#contact-GET__contacttable-vip-entry}{#contact-GET__contacttable-web_service_access_only-entry}{#contact-GET__contacttable-zip-entry}
| 要素 | 説明 |
|-|-|
| account | 連絡先が関連付けられているアカウントレコードの sys_id。アカウント \[customer_account\] テーブル。 データタイプ：文字列 |
| active | システム内で連絡先がアクティブかどうかを示すフラグ。 可能な値： * true：連絡先はアクティブです。 * false：連絡先は非アクティブです。 データタイプ：ブール デフォルト：true |
| agent_status | エージェントのステータス。 可能な値： * 業務時間外 * ブレーク時 * ルーティング時 * 現地 データタイプ：文字列 最大長：40 |
| 建物 | 連絡先が居住する建物を説明するレコードの sys_id。建物 \[cmn_building\] テーブル。 データタイプ：文字列 |
| calendar_integration | 連絡先が使用するカレンダーアプリケーション。 1：Outlook データタイプ：数値 (整数) デフォルト値：1 |
| city | 連絡先が居住する市区町村。 データタイプ：文字列 最大長：40 |
| company | 連絡先が関連付けられている会社レコードの sys_id。会社 \[core_company\] テーブル。 データタイプ：文字列 |
| cost_center | 連絡先に関連付けられているコストセンターの sys_id。コストセンター \[cmn_cost_center\] テーブル データタイプ：文字列 |
| country | 連絡先が居住する国の国コード。 データタイプ：文字列 最大長：3 |
| date_format | 連絡先に日付を表示する形式。 有効な値： * dd/mm/yyyy * dd-mm-yyyy * dd.mm.yyyy * mm-dd-yyyy * yyyy-mm-dd データタイプ：文字列 最大長：40 デフォルト：空 (システム日付形式) |
| default_perspective | 連絡先のデフォルトの視点の sys_id。メニューリスト \[sys_perspective\] テーブルにあります。 データタイプ：文字列 |
| department | 連絡先に関連付けられた部門の sys_id。部門 \[cmn_department\] テーブルにあります。 データタイプ：文字列 |
| edu_status | 関連付けられた連絡先の学歴ステータス。 データタイプ：文字列 最大長：40 デフォルト：faculty |
| email | 連絡先のメールアドレス。 データタイプ：文字列 |
| employee_number | 連絡先の従業員番号。 データタイプ：文字列 |
| enable_multifactor_authn | 連絡先がサービスポータルにログインするためにマルチファクター認証が必要かどうかを示すフラグ。 可能な値： * true：マルチファクター認証が有効 * false：マルチファクター認証が無効 データタイプ：ブール デフォルト値：false |
| failed_attempts | 失敗したログイン試行回数。 データタイプ：数値 (整数) |
| first_name | 連絡先の名。 データタイプ：文字列 最大長：50 |
| gender | 連絡先の性別。 データタイプ：文字列 最大長：40 |
| geolocation_tracked | 連絡先の場所が位置情報追跡によって取得されたかどうかを示すフラグ。 可能な値： * true：連絡先の場所は位置情報追跡によって取得された * false：連絡先の場所は位置情報追跡によって取得されていない データタイプ：ブール デフォルト値：false |
| home_phone | 連絡先の自宅電話番号。 データタイプ：文字列 最大長：40 |
| internal_integration_user | 連絡先が内部統合ユーザーかどうかを示すフラグ。 可能な値： * true：内部統合ユーザー * false：他のタイプのユーザー データタイプ：ブール デフォルト値：false |
| introduction | 前書き データタイプ：文字列 最大長：40 |
| last_login | 連絡先が最後にシステムにログインした日付。 データタイプ：文字列 (日付) |
| last_login_device | コンシューマーが最後にシステムにログインしたときに使用したデバイス。 データタイプ：文字列 最大長：40 |
| last_login_time | 連絡先がシステムにログインした日時。 データタイプ：文字列 (日付/時間) |
| last_name | 連絡先の姓。 データタイプ：文字列 最大長：50 |
| last_position_update | 位置が最後に更新された日時。 データタイプ：文字列 (日付/時間) |
| latitude | 連絡先の緯度座標。 データタイプ：数値 (浮動小数点) 最大長：40 |
| ldap_server | 連絡先がシステムに最後にログインしたときに使用した LDAP サーバーの sys_id。LDAP サーバー \[ldap_server_config\] テーブル データタイプ：文字列 |
| location | 連絡先の場所を記述するレコードの sys_id。場所 \[cmn_location\] テーブル データタイプ：文字列 |
| locked_out | 連絡先がロックアウトされているかどうかを示すフラグ。 可能な値： * true：連絡先がロックアウトされました * false：連絡先はロックアウトされていません データタイプ：ブール デフォルト値：false |
| 経度 | 連絡先の経度座標。 データタイプ：数値 (浮動小数点) 最大長：40 |
| manager | 連絡先の直属の上司を記述したレコードの sys_id。ユーザー \[sys_user\] テーブル。 データタイプ：文字列 |
| middle_name | 連絡先のミドルネーム。 データタイプ：数値 (浮動小数点) 最大長：50 |
| mobile_phone | 連絡先の携帯電話番号。 データタイプ：文字列 最大長：40 |
| name | 連絡先のフルネーム。 データタイプ：文字列 最大長：151 |
| notification | 連絡先が通知を受信するかどうかを示します。 有効な値： * 1：無効 * 2：有効 データタイプ：数値 (整数) デフォルト値：2 |
| on_schedule | ディスパッチされたサービス担当者の適時性を示します。 有効な値： * Ahead：スケジュールの前倒し。 * behind_less30：スケジュール遅延 (ただし 30 分未満)。 * behind_30to60：スケジュール遅延 (30 ～ 60 分)。 * behind_more60：スケジュール遅延 (60 分超)。 * on_time：スケジュールどおり。 データタイプ：文字列 最大長：40 |
| phone | 連絡先の勤務先電話番号。 データタイプ：文字列 最大長：40 |
| photo | 連絡先の写真画像。 データタイプ：画像 |
| preferred_language | 連絡先のプライマリ言語の国コード。 データタイプ：文字列 最大長：3 |
| roles | 連絡先に関連付けられているユーザーロールのリスト。 データタイプ：文字列 最大長：40 |
| schedule | 関連する連絡先の作業スケジュールを記述するレコードの sys_id。スケジュール \[cmn_schedule\] テーブル。 データタイプ：文字列 |
| source | 連絡先のソース。 データタイプ：文字列 最大長：255 |
| state | 連絡先が居住する都道府県。 データタイプ：文字列 最大長：40 |
| street | 連絡先の番地。 データタイプ：文字列 最大長：255 |
| sys_class_name | 連絡先レコードを含むテーブル。 データタイプ：文字列 最大長：80 |
| sys_created_by | 関連付けられた連絡先レコードを最初に作成したユーザー。 データタイプ：文字列 最大長：40 |
| sys_created_on | 関連付けられた連絡先が最初に作成された日時。 データタイプ：文字列 (日付/時間) |
| sys_domain | 関連付けられた連絡先レコードの ServiceNow インスタンスドメイン。 データタイプ：文字列 |
| sys_domain_path | 連絡先レコードのドメインパス。 データタイプ：文字列 最大長：255 デフォルト：/ (global) |
| sys_id | 関連付けられた連絡先レコードの一意の識別子。 データタイプ：文字列 |
| sys_mod_count | 関連付けられた連絡先レコードが変更された回数。 データタイプ：数値 (整数) |
| sys_tags | システムタグ。 データタイプ：文字列 |
| sys_updated_by | 関連付けられた連絡先情報を最後に更新したユーザー。 データタイプ：文字列 最大長：40 |
| sys_updated_on | 関連付けられた連絡先情報が更新された日時。 データタイプ：文字列 (日付/時間) |
| time_format | 時間を表示する形式。 有効な値： * hh.mm.ss a: hh.mm.ss (12 時間制) * hh:mm:ss a: hh:mm:ss (12 時間制) * HH.mm.ss: hh.mm.ss (24 時間制) * HH:mm:ss: hh:mm:ss (24 時間制) データタイプ：文字列 最大長：40 デフォルト：空 (システム時間形式) |
| time_sheet_policy | 関連する連絡先のタイムシートポリシーを含むレコードの sys_id。タイムシートポリシー \[time_sheet_policy\] テーブル。 データタイプ：文字列 |
| time_zone | 連絡先が居住するタイムゾーン (カナダ/中央または米国/東部)。 データタイプ：文字列 最大長：40 |
| title | マネージャー、ソフトウェア開発者、請負業者などの連絡先のビジネスタイトル。 データタイプ：文字列 最大長：60 |
| user_name | 連絡先のユーザー ID。 データタイプ：文字列 最大長：40 |
| vip | 関連付けられた連絡先が VIP ステータスかどうかを示すフラグ。 可能な値： * true：VIP * false：VIP ではない データタイプ：ブール デフォルト値：false |
| web_service_access_only | 連絡先が Web 経由でのみサービスにアクセスできるかどうかを示すフラグ。 可能な値： * true：Web アクセスのみ * false：利用可能なすべての方法によるアクセス データタイプ：ブール デフォルト値：false |
| zip | 連絡先の郵便番号。 データタイプ：文字列 最大長：40 |
[ ]
### cURL 要求
curl "https://instance.servicenow.com/api/now/contact?sysparm_query=account=86837a386f0331003b3c498f5d3ee4ca&sysparm_limit=2&sysparm_offset=2>;rel="next" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"
{
"result": [
{
"country": "",
"calendar_integration": "1",
"last_position_update": "",
"last_login_time": "2018-03-10 21:48:11",
"last_login_device": "",
"source": "",
"sys_updated_on": "2019-01-03 05:49:34",
"building": "",
"web_service_access_only": "false",
"notification": "2",
"sys_updated_by": "system",
"enable_multifactor_authn": "false",
"sys_created_on": "2018-03-04 20:26:32",
"sys_domain": "global",
"agent_status": "",
"state": "",
"vip": "false",
"sys_created_by": "admin",
"longitude": "",
"zip": "",
"home_phone": "",
"time_format": "",
"last_login": "",
"default_perspective": "",
"geolocation_tracked": "false",
"active": "true",
"time_sheet_policy": "",
"sys_domain_path": "/",
"phone": "+1 858 287 7834",
"cost_center": "",
"name": "George Warren",
"employee_number": "",
"gender": "",
"city": "",
"user_name": "george.warren",
"failed_attempts": "",
"edu_status": "",
"latitude": "",
"roles": "",
"title": "Network Administrator",
"sys_class_name": "customer_contact",
"sys_id": "ddce70866f9331003b3c498f5d3ee417",
"internal_integration_user": "false",
"ldap_server": "",
"mobile_phone": "+1 858 867 7857",
"street": "",
"company": "86837a386f0331003b3c498f5d3ee4ca",
"department": "",
"first_name": "George",
"preferred_language": "",
"introduction": "",
"email": "geo.warren@mailinator.com",
"manager": "",
"locked_out": "false",
"sys_mod_count": "3",
"last_name": "Warren",
"photo": "",
"sys_tags": "",
"middle_name": "",
"time_zone": "",
"schedule": "",
"on_schedule": "",
"date_format": "",
"location": "25ab8e460a0a0bb300857304ff811af5",
"account": "86837a386f0331003b3c498f5d3ee4ca"
},
{
"country": "",
"calendar_integration": "1",
"last_position_update": "",
"last_login_time": "2019-01-03 15:08:57",
"last_login_device": "73.71.157.241",
"source": "",
"sys_updated_on": "2019-01-03 23:26:12",
"building": "",
"web_service_access_only": "false",
"notification": "2",
"sys_updated_by": "admin",
"enable_multifactor_authn": "false",
"sys_created_on": "2019-01-03 15:07:25",
"sys_domain": "global",
"agent_status": "",
"state": "",
"vip": "false",
"sys_created_by": "carl.customer",
"longitude": "",
"zip": "",
"home_phone": "",
"time_format": "",
"last_login": "",
"default_perspective": "",
"geolocation_tracked": "false",
"active": "true",
"time_sheet_policy": "",
"sys_domain_path": "/",
"phone": "+16692627777",
"cost_center": "",
"name": "Jane Contact",
"employee_number": "",
"gender": "",
"city": "",
"user_name": "Jane.Contact",
"failed_attempts": "",
"edu_status": "faculty",
"latitude": "",
"roles": "",
"title": "",
"sys_class_name": "customer_contact",
"sys_id": "0a232a0013691200042ab3173244b075",
"internal_integration_user": "false",
"ldap_server": "",
"mobile_phone": "",
"street": "",
"company": "86837a386f0331003b3c498f5d3ee4ca",
"department": "",
"first_name": "Jane",
"preferred_language": "",
"introduction": "",
"email": "jane.contact@mailinator.com",
"manager": "",
"locked_out": "false",
"sys_mod_count": "3",
"last_name": "Contact",
"photo": "",
"sys_tags": "",
"middle_name": "",
"time_zone": "",
"schedule": "",
"on_schedule": "",
"date_format": "",
"location": "",
"account": "86837a386f0331003b3c498f5d3ee4ca"
}
]
}
## 連絡先 - GET /now/contact/{id} {#ariaid-title3}
指定された カスタマーサービス管理 (CSM) 連絡先を取得します。
### URL 形式
バージョニングされた URL：/api/now/{api_version}/contact/{id}
デフォルトの URL：/api/now/contact/{id}
### サポートされている要求パラメーター
{#contact-GET-id__entry__2}{#contact-GET-id__version-RESTAPI}
| 名前 | 説明 |
|-|-|
| api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 |
| id | 取得する連絡先の sys_id。連絡先 \[customer_contact\] テーブルにあります。 |
[表 : 7. パスパラメーター]
{#contact-GET-id__entry__8}
| 名前 | 説明 |
|-|-|
| なし | |
[表 : 8. クエリパラメーター]
{#contact-GET-id__entry__12}
| 名前 | 説明 |
|-|-|
| なし | |
[表 : 9. 要求本文パラメーター (XML または JSON)]
### ヘッダー
次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。
{#contact-GET-id__entry__16}{#contact-GET-id__accept-RESTAPI}
| ヘッダー | 説明 |
|-|-|
| 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json |
[表 : 10. 要求ヘッダー]
{#contact-GET-id__entry__20}
| ヘッダー | 説明 |
|-|-|
| なし | |
[表 : 11. 応答ヘッダー]
### ステータスコード
この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。
{#contact-GET-id__entry__24}{#contact-GET-id__entry-200-status-code}{#contact-GET-id__entry-401-status-code}{#contact-GET-id__entry-500-status-code}
| ステータスコード | 説明 |
|-|-|
| 200 | 成功。要求が正常に処理されました。 |
| 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 |
| 404 | 要求が無効であることを示します。次のいずれかの理由が考えられます。 * 要求されたケースが存在しません。 * ユーザーにはケースへのアクセス権がありません。 {#contact-GET-id__ul_ubm_1jl_3v} |
| 500 | 内部サーバーエラー。要求の処理中に予期しないエラーが発生しました。応答に、エラーに関する追加情報が含まれます。 |
[表 : 12. ステータスコード]
### 応答本文のパラメーター (JSON または XML)
エンドポイントでは、次の JSON または XML 要素を応答本文で返すことができます。以下で定義する (ベースシステムにある要素を定義する) 要素のリストに加えて、エンドポイントでは、連絡先 \[customer_contact\] テーブルに追加されたカスタムフィールドも返します。これらの要素の詳細については、特定のテーブル定義 \[システム定義テーブル\].
{#contact-GET-id__csmcontact_response_parms__entry__2}{#contact-GET-id__contacttable-account-enrty}{#contact-GET-id__contacttable-active-entry}{#contact-GET-id__contacttable-agent_status-entry}{#contact-GET-id__contacttable-building-entry}{#contact-GET-id__contacttable-calendar_integration-entry}{#contact-GET-id__contacttable-city-entry}{#contact-GET-id__contacttable-company-entry}{#contact-GET-id__contacttable-cost_center-entry}{#contact-GET-id__contacttable-country-entry}{#contact-GET-id__contacttable-date_format-entry}{#contact-GET-id__contacttable-default_perspective-entry}{#contact-GET-id__contacttable-department-entry}{#contact-GET-id__contacttable-edu_status-entry}{#contact-GET-id__contacttable-email-entry}{#contact-GET-id__contacttable-employee_number-entry}{#contact-GET-id__contacttable-enable_multifactor_authn-entry}{#contact-GET-id__contacttable-failed_attempts-entry}{#contact-GET-id__contacttable-first_name-entry}{#contact-GET-id__contacttable-gender-entry}{#contact-GET-id__contacttable-geolocation_tracked-entry}{#contact-GET-id__contacttable-home_phone-entry}{#contact-GET-id__contacttable-internal_integration_user-entry}{#contact-GET-id__contacttable-introduction-entry}{#contact-GET-id__contacttable-last_login-entry}{#contact-GET-id__contacttable-last_login_device-entry}{#contact-GET-id__contacttable-last_login_time-entry}{#contact-GET-id__contacttable-last_name-entry}{#contact-GET-id__contacttable-last_position_update-entry}{#contact-GET-id__contacttable-latitude-entry}{#contact-GET-id__contacttable-ldap_server-entry}{#contact-GET-id__contacttable-location-entry}{#contact-GET-id__contacttable-locked_out-entry}{#contact-GET-id__contacttable-longitude-entry}{#contact-GET-id__contacttable-manager-entry}{#contact-GET-id__contacttable-middle_name-entry}{#contact-GET-id__contacttable-mobile_phone-entry}{#contact-GET-id__contacttable-name-entry}{#contact-GET-id__contacttable-notification-entry}{#contact-GET-id__contacttable-on_schedule-entry}{#contact-GET-id__contacttable-phone-entry}{#contact-GET-id__contacttable-photo-entry}{#contact-GET-id__contacttable-preferred_language-entry}{#contact-GET-id__contacttable-roles-entry}{#contact-GET-id__contacttable-schedule-entry}{#contact-GET-id__contacttable-source-entry}{#contact-GET-id__contacttable-state-entry}{#contact-GET-id__contacttable-street-entry}{#contact-GET-id__contacttable-sys_class_name-entry}{#contact-GET-id__contacttable-sys_created_by-entry}{#contact-GET-id__contacttable-sys_created_on-entry}{#contact-GET-id__contacttable-sys_domain-entry}{#contact-GET-id__contacttable-sys_domain_path-entry}{#contact-GET-id__contacttable-sys_id-entry}{#contact-GET-id__contacttable-sys_mod_count-entry}{#contact-GET-id__contacttable-sys_updated_by-entry}{#contact-GET-id__contacttable-sys_updated_on-entry}{#contact-GET-id__contacttable-time_format-entry}{#contact-GET-id__contacttable-time_sheet_policy-entry}{#contact-GET-id__contacttable-time_zone-entry}{#contact-GET-id__contacttable-title-entry}{#contact-GET-id__contacttable-user_name-entry}{#contact-GET-id__contacttable-vip-entry}{#contact-GET-id__contacttable-web_service_access_only-entry}{#contact-GET-id__contacttable-zip-entry}
| 要素 | 説明 |
|-|-|
| account | 連絡先が関連付けられているアカウントレコードの sys_id。アカウント \[customer_account\] テーブル。 データタイプ：文字列 |
| active | システム内で連絡先がアクティブかどうかを示すフラグ。 可能な値： * true：連絡先はアクティブです。 * false：連絡先は非アクティブです。 データタイプ：ブール デフォルト：true |
| agent_status | エージェントのステータス。 可能な値： * 業務時間外 * ブレーク時 * ルーティング時 * 現地 データタイプ：文字列 最大長：40 |
| 建物 | 連絡先が居住する建物を説明するレコードの sys_id。建物 \[cmn_building\] テーブル。 データタイプ：文字列 |
| calendar_integration | 連絡先が使用するカレンダーアプリケーション。 1：Outlook データタイプ：数値 (整数) デフォルト値：1 |
| city | 連絡先が居住する市区町村。 データタイプ：文字列 最大長：40 |
| company | 連絡先が関連付けられている会社レコードの sys_id。会社 \[core_company\] テーブル。 データタイプ：文字列 |
| cost_center | 連絡先に関連付けられているコストセンターの sys_id。コストセンター \[cmn_cost_center\] テーブル データタイプ：文字列 |
| country | 連絡先が居住する国の国コード。 データタイプ：文字列 最大長：3 |
| date_format | 連絡先に日付を表示する形式。 有効な値： * dd/mm/yyyy * dd-mm-yyyy * dd.mm.yyyy * mm-dd-yyyy * yyyy-mm-dd データタイプ：文字列 最大長：40 デフォルト：空 (システム日付形式) |
| default_perspective | 連絡先のデフォルトの視点の sys_id。メニューリスト \[sys_perspective\] テーブルにあります。 データタイプ：文字列 |
| department | 連絡先に関連付けられた部門の sys_id。部門 \[cmn_department\] テーブルにあります。 データタイプ：文字列 |
| edu_status | 関連付けられた連絡先の学歴ステータス。 データタイプ：文字列 最大長：40 デフォルト：faculty |
| email | 連絡先のメールアドレス。 データタイプ：文字列 |
| employee_number | 連絡先の従業員番号。 データタイプ：文字列 |
| enable_multifactor_authn | 連絡先がサービスポータルにログインするためにマルチファクター認証が必要かどうかを示すフラグ。 可能な値： * true：マルチファクター認証が有効 * false：マルチファクター認証が無効 データタイプ：ブール デフォルト値：false |
| failed_attempts | 失敗したログイン試行回数。 データタイプ：数値 (整数) |
| first_name | 連絡先の名。 データタイプ：文字列 最大長：50 |
| gender | 連絡先の性別。 データタイプ：文字列 最大長：40 |
| geolocation_tracked | 連絡先の場所が位置情報追跡によって取得されたかどうかを示すフラグ。 可能な値： * true：連絡先の場所は位置情報追跡によって取得された * false：連絡先の場所は位置情報追跡によって取得されていない データタイプ：ブール デフォルト値：false |
| home_phone | 連絡先の自宅電話番号。 データタイプ：文字列 最大長：40 |
| internal_integration_user | 連絡先が内部統合ユーザーかどうかを示すフラグ。 可能な値： * true：内部統合ユーザー * false：他のタイプのユーザー データタイプ：ブール デフォルト値：false |
| introduction | 前書き データタイプ：文字列 最大長：40 |
| last_login | 連絡先が最後にシステムにログインした日付。 データタイプ：文字列 (日付) |
| last_login_device | コンシューマーが最後にシステムにログインしたときに使用したデバイス。 データタイプ：文字列 最大長：40 |
| last_login_time | 連絡先がシステムにログインした日時。 データタイプ：文字列 (日付/時間) |
| last_name | 連絡先の姓。 データタイプ：文字列 最大長：50 |
| last_position_update | 位置が最後に更新された日時。 データタイプ：文字列 (日付/時間) |
| latitude | 連絡先の緯度座標。 データタイプ：数値 (浮動小数点) 最大長：40 |
| ldap_server | 連絡先がシステムに最後にログインしたときに使用した LDAP サーバーの sys_id。LDAP サーバー \[ldap_server_config\] テーブル データタイプ：文字列 |
| location | 連絡先の場所を記述するレコードの sys_id。場所 \[cmn_location\] テーブル データタイプ：文字列 |
| locked_out | 連絡先がロックアウトされているかどうかを示すフラグ。 可能な値： * true：連絡先がロックアウトされました * false：連絡先はロックアウトされていません データタイプ：ブール デフォルト値：false |
| 経度 | 連絡先の経度座標。 データタイプ：数値 (浮動小数点) 最大長：40 |
| manager | 連絡先の直属の上司を記述したレコードの sys_id。ユーザー \[sys_user\] テーブル。 データタイプ：文字列 |
| middle_name | 連絡先のミドルネーム。 データタイプ：数値 (浮動小数点) 最大長：50 |
| mobile_phone | 連絡先の携帯電話番号。 データタイプ：文字列 最大長：40 |
| name | 連絡先のフルネーム。 データタイプ：文字列 最大長：151 |
| notification | 連絡先が通知を受信するかどうかを示します。 有効な値： * 1：無効 * 2：有効 データタイプ：数値 (整数) デフォルト値：2 |
| on_schedule | ディスパッチされたサービス担当者の適時性を示します。 有効な値： * Ahead：スケジュールの前倒し。 * behind_less30：スケジュール遅延 (ただし 30 分未満)。 * behind_30to60：スケジュール遅延 (30 ～ 60 分)。 * behind_more60：スケジュール遅延 (60 分超)。 * on_time：スケジュールどおり。 データタイプ：文字列 最大長：40 |
| phone | 連絡先の勤務先電話番号。 データタイプ：文字列 最大長：40 |
| photo | 連絡先の写真画像。 データタイプ：画像 |
| preferred_language | 連絡先のプライマリ言語の国コード。 データタイプ：文字列 最大長：3 |
| roles | 連絡先に関連付けられているユーザーロールのリスト。 データタイプ：文字列 最大長：40 |
| schedule | 関連する連絡先の作業スケジュールを記述するレコードの sys_id。スケジュール \[cmn_schedule\] テーブル。 データタイプ：文字列 |
| source | 連絡先のソース。 データタイプ：文字列 最大長：255 |
| state | 連絡先が居住する都道府県。 データタイプ：文字列 最大長：40 |
| street | 連絡先の番地。 データタイプ：文字列 最大長：255 |
| sys_class_name | 連絡先レコードを含むテーブル。 データタイプ：文字列 最大長：80 |
| sys_created_by | 関連付けられた連絡先レコードを最初に作成したユーザー。 データタイプ：文字列 最大長：40 |
| sys_created_on | 関連付けられた連絡先が最初に作成された日時。 データタイプ：文字列 (日付/時間) |
| sys_domain | 関連付けられた連絡先レコードの ServiceNow インスタンスドメイン。 データタイプ：文字列 |
| sys_domain_path | 連絡先レコードのドメインパス。 データタイプ：文字列 最大長：255 デフォルト：/ (global) |
| sys_id | 関連付けられた連絡先レコードの一意の識別子。 データタイプ：文字列 |
| sys_mod_count | 関連付けられた連絡先レコードが変更された回数。 データタイプ：数値 (整数) |
| sys_updated_by | 関連付けられた連絡先情報を最後に更新したユーザー。 データタイプ：文字列 最大長：40 |
| sys_updated_on | 関連付けられた連絡先情報が更新された日時。 データタイプ：文字列 (日付/時間) |
| time_format | 時間を表示する形式。 有効な値： * hh.mm.ss a: hh.mm.ss (12 時間制) * hh:mm:ss a: hh:mm:ss (12 時間制) * HH.mm.ss: hh.mm.ss (24 時間制) * HH:mm:ss: hh:mm:ss (24 時間制) データタイプ：文字列 最大長：40 デフォルト：空 (システム時間形式) |
| time_sheet_policy | 関連する連絡先のタイムシートポリシーを含むレコードの sys_id。タイムシートポリシー \[time_sheet_policy\] テーブル。 データタイプ：文字列 |
| time_zone | 連絡先が居住するタイムゾーン (カナダ/中央または米国/東部)。 データタイプ：文字列 最大長：40 |
| title | マネージャー、ソフトウェア開発者、請負業者などの連絡先のビジネスタイトル。 データタイプ：文字列 最大長：60 |
| user_name | 連絡先のユーザー ID。 データタイプ：文字列 最大長：40 |
| vip | 関連付けられた連絡先が VIP ステータスかどうかを示すフラグ。 可能な値： * true：VIP * false：VIP ではない データタイプ：ブール デフォルト値：false |
| web_service_access_only | 連絡先が Web 経由でのみサービスにアクセスできるかどうかを示すフラグ。 可能な値： * true：Web アクセスのみ * false：利用可能なすべての方法によるアクセス データタイプ：ブール デフォルト値：false |
| zip | 連絡先の郵便番号。 データタイプ：文字列 最大長：40 |
[ ]
### cURL 要求
curl "https://instance.servicenow.com/api/now/contact/ddce70866f9331003b3c498f5d3ee417 \
--request GET \
--header "Accept:application/json" \
--user "username":"password"
{
"result": {
"country": "",
"calendar_integration": "1",
"last_position_update": "",
"last_login_time": "2018-03-10 21:48:11",
"last_login_device": "",
"source": "",
"sys_updated_on": "2019-01-03 05:49:34",
"building": "",
"web_service_access_only": "false",
"notification": "2",
"sys_updated_by": "system",
"enable_multifactor_authn": "false",
"sys_created_on": "2018-03-04 20:26:32",
"sys_domain": "global",
"agent_status": "",
"state": "",
"vip": "false",
"sys_created_by": "admin",
"longitude": "",
"zip": "",
"home_phone": "",
"time_format": "",
"last_login": "",
"default_perspective": "",
"geolocation_tracked": "false",
"active": "true",
"time_sheet_policy": "",
"sys_domain_path": "/",
"phone": "+1 858 287 7834",
"cost_center": "",
"name": "George Warren",
"employee_number": "",
"gender": "",
"city": "",
"user_name": "george.warren",
"failed_attempts": "",
"edu_status": "",
"latitude": "",
"roles": "",
"title": "Network Administrator",
"sys_class_name": "customer_contact",
"sys_id": "ddce70866f9331003b3c498f5d3ee417",
"internal_integration_user": "false",
"ldap_server": "",
"mobile_phone": "+1 858 867 7857",
"street": "",
"company": "86837a386f0331003b3c498f5d3ee4ca",
"department": "",
"first_name": "George",
"preferred_language": "",
"introduction": "",
"email": "geo.warren@mailinator.com",
"manager": "",
"locked_out": "false",
"sys_mod_count": "3",
"last_name": "Warren",
"photo": "",
"sys_tags": "",
"middle_name": "",
"time_zone": "",
"schedule": "",
"on_schedule": "",
"date_format": "",
"location": "25ab8e460a0a0bb300857304ff811af5",
"account": "86837a386f0331003b3c498f5d3ee4ca"
}
}
## 連絡先 - POST /now/contact {#ariaid-title4}
新しい カスタマーサービス管理 (CSM) 連絡先を作成します。
さらに、このエンドポイントを使用して、連絡先のソーシャルメディアプロファイルを作成できます。プロファイルを作成するには、要求本文で次のパラメーターを指定する必要があります。
* social_channel
* social_handle
* social_handle_url
{#contact-POST__ul_ntx_lg4_pgb}
警告:
このエンドポイントでパラメーターの検証を実行すると、過度のオーバーヘッドが発生する可能性があるため、パラメーターの検証を実行しません。要求パラメーターが、スペルが間違っている、有効ではない、またはエンドポイントでサポートされていない場合、警告なしで無視されます。
### URL 形式
バージョニングされた URL：/api/now/{api_version}/contact
デフォルトの URL：/api/now/contact
### サポートされている要求パラメーター
{#contact-POST__entry__2}{#contact-POST__version-RESTAPI}
| 名前 | 説明 |
|-|-|
| api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 |
[表 : 13. パスパラメーター]
{#contact-POST__entry__6}
| 名前 | 説明 |
|-|-|
| なし | |
[表 : 14. クエリパラメーター]
{#contact-POST__entry__10}{#contact-POST__contacttable-account-enrty}{#contact-POST__contacttable-active-entry}{#contact-POST__contacttable-agent_status-entry}{#contact-POST__contacttable-building-entry}{#contact-POST__contacttable-calendar_integration-entry}{#contact-POST__contacttable-city-entry}{#contact-POST__contacttable-company-entry}{#contact-POST__contacttable-cost_center-entry}{#contact-POST__contacttable-country-entry}{#contact-POST__contacttable-date_format-entry}{#contact-POST__contacttable-default_perspective-entry}{#contact-POST__contacttable-department-entry}{#contact-POST__contacttable-edu_status-entry}{#contact-POST__contacttable-email-entry}{#contact-POST__contacttable-employee_number-entry}{#contact-POST__contacttable-enable_multifactor_authn-entry}{#contact-POST__contacttable-failed_attempts-entry}{#contact-POST__contacttable-first_name-entry}{#contact-POST__contacttable-gender-entry}{#contact-POST__contacttable-geolocation_tracked-entry}{#contact-POST__contacttable-home_phone-entry}{#contact-POST__contacttable-internal_integration_user-entry}{#contact-POST__contacttable-introduction-entry}{#contact-POST__contacttable-last_login_device-entry}{#contact-POST__contacttable-last_login_time-entry}{#contact-POST__contacttable-last_name-entry}{#contact-POST__contacttable-latitude-entry}{#contact-POST__contacttable-ldap_server-entry}{#contact-POST__contacttable-location-entry}{#contact-POST__contacttable-locked_out-entry}{#contact-POST__contacttable-longitude-entry}{#contact-POST__contacttable-manager-entry}{#contact-POST__contacttable-middle_name-entry}{#contact-POST__contacttable-mobile_phone-entry}{#contact-POST__contacttable-name-entry}{#contact-POST__contacttable-notification-entry}{#contact-POST__contacttable-on_schedule-entry}{#contact-POST__contacttable-phone-entry}{#contact-POST__contacttable-photo-entry}{#contact-POST__contacttable-preferred_language-entry}{#contact-POST__contacttable-roles-entry}{#contact-POST__contacttable-schedule-entry}{#contact-POST__contacttable-source-entry}{#contact-POST__contacttable-state-entry}{#contact-POST__contacttable-street-entry}{#contact-POST__contacttable-time_format-entry}{#contact-POST__contacttable-time_sheet_policy-entry}{#contact-POST__contacttable-time_zone-entry}{#contact-POST__contacttable-title-entry}{#contact-POST__contacttable-user_name-entry}{#contact-POST__contacttable-vip-entry}{#contact-POST__contacttable-web_service_access_only-entry}{#contact-POST__contacttable-zip-entry}
| 要素 | 説明 |
|-|-|
| account | 連絡先が関連付けられているアカウントレコードの sys_id。アカウント \[customer_account\] テーブル。 データタイプ：文字列 |
| active | システム内で連絡先がアクティブかどうかを示すフラグ。 可能な値： * true：連絡先はアクティブです。 * false：連絡先は非アクティブです。 データタイプ：ブール デフォルト：true |
| agent_status | エージェントのステータス。 可能な値： * 業務時間外 * ブレーク時 * ルーティング時 * 現地 データタイプ：文字列 最大長：40 |
| 建物 | 連絡先が居住する建物を説明するレコードの sys_id。建物 \[cmn_building\] テーブル。 データタイプ：文字列 |
| calendar_integration | 連絡先が使用するカレンダーアプリケーション。 1：Outlook データタイプ：数値 (整数) デフォルト値：1 |
| city | 連絡先が居住する市区町村。 データタイプ：文字列 最大長：40 |
| company | 連絡先が関連付けられている会社レコードの sys_id。会社 \[core_company\] テーブル。 データタイプ：文字列 |
| cost_center | 連絡先に関連付けられているコストセンターの sys_id。コストセンター \[cmn_cost_center\] テーブル データタイプ：文字列 |
| country | 連絡先が居住する国の国コード。 データタイプ：文字列 最大長：3 |
| date_format | 連絡先に日付を表示する形式。 有効な値： * dd/mm/yyyy * dd-mm-yyyy * dd.mm.yyyy * mm-dd-yyyy * yyyy-mm-dd データタイプ：文字列 最大長：40 デフォルト：空 (システム日付形式) |
| default_perspective | 連絡先のデフォルトの視点の sys_id。メニューリスト \[sys_perspective\] テーブルにあります。 データタイプ：文字列 |
| department | 連絡先に関連付けられた部門の sys_id。部門 \[cmn_department\] テーブルにあります。 データタイプ：文字列 |
| edu_status | 関連付けられた連絡先の学歴ステータス。 データタイプ：文字列 最大長：40 デフォルト：faculty |
| email | 連絡先のメールアドレス。 データタイプ：文字列 |
| employee_number | 連絡先の従業員番号。 データタイプ：文字列 |
| enable_multifactor_authn | 連絡先がサービスポータルにログインするためにマルチファクター認証が必要かどうかを示すフラグ。 可能な値： * true：マルチファクター認証が有効 * false：マルチファクター認証が無効 データタイプ：ブール デフォルト値：false |
| failed_attempts | 失敗したログイン試行回数。 データタイプ：数値 (整数) |
| first_name | 連絡先の名。 データタイプ：文字列 最大長：50 |
| gender | 連絡先の性別。 データタイプ：文字列 最大長：40 |
| geolocation_tracked | 連絡先の場所が位置情報追跡によって取得されたかどうかを示すフラグ。 可能な値： * true：連絡先の場所は位置情報追跡によって取得された * false：連絡先の場所は位置情報追跡によって取得されていない データタイプ：ブール デフォルト値：false |
| home_phone | 連絡先の自宅電話番号。 データタイプ：文字列 最大長：40 |
| internal_integration_user | 連絡先が内部統合ユーザーかどうかを示すフラグ。 可能な値： * true：内部統合ユーザー * false：他のタイプのユーザー データタイプ：ブール デフォルト値：false |
| introduction | 前書き データタイプ：文字列 最大長：40 |
| last_login_device | コンシューマーが最後にシステムにログインしたときに使用したデバイス。 データタイプ：文字列 最大長：40 |
| last_login_time | 連絡先がシステムにログインした日時。 データタイプ：文字列 (日付/時間) |
| last_name | 連絡先の姓。 データタイプ：文字列 最大長：50 |
| latitude | 連絡先の緯度座標。 データタイプ：数値 (浮動小数点) 最大長：40 |
| ldap_server | 連絡先がシステムに最後にログインしたときに使用した LDAP サーバーの sys_id。LDAP サーバー \[ldap_server_config\] テーブル データタイプ：文字列 |
| location | 連絡先の場所を記述するレコードの sys_id。場所 \[cmn_location\] テーブル データタイプ：文字列 |
| locked_out | 連絡先がロックアウトされているかどうかを示すフラグ。 可能な値： * true：連絡先がロックアウトされました * false：連絡先はロックアウトされていません データタイプ：ブール デフォルト値：false |
| 経度 | 連絡先の経度座標。 データタイプ：数値 (浮動小数点) 最大長：40 |
| manager | 連絡先の直属の上司を記述したレコードの sys_id。ユーザー \[sys_user\] テーブル。 データタイプ：文字列 |
| middle_name | 連絡先のミドルネーム。 データタイプ：数値 (浮動小数点) 最大長：50 |
| mobile_phone | 連絡先の携帯電話番号。 データタイプ：文字列 最大長：40 |
| name | 連絡先のフルネーム。 データタイプ：文字列 最大長：151 |
| notification | 連絡先が通知を受信するかどうかを示します。 有効な値： * 1：無効 * 2：有効 データタイプ：数値 (整数) デフォルト値：2 |
| on_schedule | ディスパッチされたサービス担当者の適時性を示します。 有効な値： * Ahead：スケジュールの前倒し。 * behind_less30：スケジュール遅延 (ただし 30 分未満)。 * behind_30to60：スケジュール遅延 (30 ～ 60 分)。 * behind_more60：スケジュール遅延 (60 分超)。 * on_time：スケジュールどおり。 データタイプ：文字列 最大長：40 |
| phone | 連絡先の勤務先電話番号。 データタイプ：文字列 最大長：40 |
| photo | 連絡先の写真画像。 データタイプ：画像 |
| preferred_language | 連絡先のプライマリ言語の国コード。 データタイプ：文字列 最大長：3 |
| roles | 連絡先に関連付けられているユーザーロールのリスト。 データタイプ：文字列 最大長：40 |
| schedule | 関連する連絡先の作業スケジュールを記述するレコードの sys_id。スケジュール \[cmn_schedule\] テーブル。 データタイプ：文字列 |
| social_channel | 連絡先が関連付けられているソーシャルメディアチャネル (Twitter、Facebook、Instagram など)。 データタイプ：文字列 |
| social_handle | ソーシャルメディアチャネルのユーザーハンドル。 データタイプ：文字列 |
| social_handle_url | 連絡先のソーシャルチャネルプロファイルへの URL。 データタイプ：文字列 |
| source | 連絡先のソース。 データタイプ：文字列 最大長：255 |
| state | 連絡先が居住する都道府県。 データタイプ：文字列 最大長：40 |
| street | 連絡先の番地。 データタイプ：文字列 最大長：255 |
| time_format | 時間を表示する形式。 有効な値： * hh.mm.ss a: hh.mm.ss (12 時間制) * hh:mm:ss a: hh:mm:ss (12 時間制) * HH.mm.ss: hh.mm.ss (24 時間制) * HH:mm:ss: hh:mm:ss (24 時間制) データタイプ：文字列 最大長：40 デフォルト：空 (システム時間形式) |
| time_sheet_policy | 関連する連絡先のタイムシートポリシーを含むレコードの sys_id。タイムシートポリシー \[time_sheet_policy\] テーブル。 データタイプ：文字列 |
| time_zone | 連絡先が居住するタイムゾーン (カナダ/中央または米国/東部)。 データタイプ：文字列 最大長：40 |
| title | マネージャー、ソフトウェア開発者、請負業者などの連絡先のビジネスタイトル。 データタイプ：文字列 最大長：60 |
| user_name | 連絡先のユーザー ID。 データタイプ：文字列 最大長：40 |
| vip | 関連付けられた連絡先が VIP ステータスかどうかを示すフラグ。 可能な値： * true：VIP * false：VIP ではない データタイプ：ブール デフォルト値：false |
| web_service_access_only | 連絡先が Web 経由でのみサービスにアクセスできるかどうかを示すフラグ。 可能な値： * true：Web アクセスのみ * false：利用可能なすべての方法によるアクセス データタイプ：ブール デフォルト値：false |
| zip | 連絡先の郵便番号。 データタイプ：文字列 最大長：40 |
[表 : 15. 要求本文パラメーター (XML または JSON)]
### ヘッダー
次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。
{#contact-POST__entry__124}{#contact-POST__accept-JSON-only-entry-RESTAPI}{#contact-POST__content_type-JSON-only-entry-RESTAPI}
| ヘッダー | 説明 |
|-|-|
| 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 |
| Content-Type | 要求本文のデータ形式。application/json のみをサポートします。 |
[表 : 16. 要求ヘッダー]
{#contact-POST__entry__130}
| ヘッダー | 説明 |
|-|-|
| なし | |
[表 : 17. 応答ヘッダー]
### ステータスコード
この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。
{#contact-POST__entry__134}{#contact-POST__entry-401-status-code}
| ステータスコード | 説明 |
|-|-|
| 201 | 新しい連絡先レコードが正常に作成されました。 |
| 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 |
| 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 |
| 500 | 内部サーバーエラー。サーバー側のコードで論理エラーが発生しました。 |
[表 : 18. ステータスコード]
### 応答本文のパラメーター (JSON または XML)
{#contact-POST__entry__144}
| 要素 | 説明 |
|-|-|
| result | 新しく作成された連絡先レコードの sys_id。 データタイプ：文字列 |
[ ]
### cURL 要求
curl -X POST "https://instance.servicenow.com/api/now/contact" \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-d '{ \
"country": "USA", \
"calendar_integration": "1", \
"last_login_time": "2018-03-10 21:48:11", \
"last_login_device": "tablet", \
"building": "Cardinal West", \
"web_service_access_only": "false", \
"notification": "1", \
"enable_multifactor_authn": "true", \
"agent_status": "Travelling", \
"state": "CA", \
"vip": "false", \
"longitude": "123.76", \
"zip": "92069", \
"home_phone": "(555)555-1234", \
"time_format": "hh:mm:ss", \
"geolocation_tracked": "false", \
"active": "true", \
"phone": "+1 858 287 7834", \
"cost_center": "1345", \
"name": "Dora Warren", \
"employee_number": "546", \
"gender": "Female", \
"city": "Orlando", \
"user_name": "dora.warren", \
"failed_attempts": "2", \
"edu_status": "current", \
"latitude": "57.6", \
"title": "Network Administrator", \
"internal_integration_user": "false", \
"ldap_server": "10.24.23.123", \
"mobile_phone": "+1 858 867 7857", \
"street": "123 Lagume", \
"company": "86837a386f0331003b3c498f5d3ee4ca", \
"department": "IT", \
"first_name": "Dora", \
"preferred_language": "Spanish", \
"email": "dora.warren@mailinator.com", \
"manager": "ddce70866f9331003b3c498f5d3ee417", \
"locked_out": "false", \
"last_name": "Warren", \
"middle_name": "Dell", \
"time_zone": "PST", \
"schedule": "9-5", \
"date_format": "MM/DD/YY", \
"location": "25ab8e460a0a0bb300857304ff811af5", \
"account": "86837a386f0331003b3c498f5d3ee4ca" \
}'
--user 'username':'password'
"result": "62fe1c97db76c3006b7a9646db961999"