---
title: "ゲスト作成(レガシー)"
slug: "create-a-guest--legacy-"
abstract: "Sitecore CDPゲストREST APIを使ってゲストを作成する方法を説明しています。"
---
# ゲスト作成(レガシー)

> !重要[このREST APIの新しいバージョン(v2.1)が利用可能です](https://api-docs.sitecore.com/cdp/guest-rest-api)。このREST APIが初めてなら、新しいバージョンを使いましょう。あるいは、すでに古いバージョンを使っているなら、[v2とv2.1の違いについて読](https://doc.sitecore.com/cdp/ja/developers/api/rest-apis/legacy-rest-apis/guest-rest-api-v2--legacy-/differences-between-v2-and-v2-1-of-the-guest-and-guest-data-extension-rest-apis.html "Differences between v2 and v2.1 of the Guest and Guest data extension REST APIs") んでアップグレードしましょう。

POST /v2/guests

ゲストを作る。

> !警告REST APIはゲスト作成時にゲストが既に存在しているかどうかを検証しません。重複ゲストの作成を避けるために、まずはゲストのメールアドレスやその他の識別情報を使って [取得](https://doc.sitecore.com/cdp/ja/developers/api/rest-apis/legacy-rest-apis/guest-rest-api-v2--legacy-/retrieve-guests--legacy-.html "Retrieve guests (legacy)") してください。

最低限、リクエスト文に以下の必要な属性を記載する必要があります:

属性

種類

概要

例

guestType

文字列エナム

獲得されたアイデンティティのレベル。

以下のいずれかでなければなりません:  
  

-   "visitor"
-   "customer"
-   "traveller"

レスポンスでは、refキーにゲスト参照が含まれています。

個人識別情報(PII)を使ってゲストを作成する:

curl -X POST '<baseURL>/v2/guests' \\
-u '<username>:<password>' \\
-H 'Accept: application/json' \\
--data-raw '
 {
 "guestType": "customer",
 "title": "Ms",
 "firstName": "Jane",
 "lastName": "Doe",
 "gender": "female",
 "dateOfBirth": "1976-10-28T00:\`00:00\`.000Z",
 "emails": 
 "jane.doe@myretailsite.com"
 ,
 "phoneNumbers": 
 "0851234567"
 ,
 "nationality": "Irish",
 "passportNumber": "PZ4A9565",
 "passportExpiry": "2033-01-01T00:00Z",
 "street": 
 "Apartment 15",
 "West Drive Avenue"
 ,
 "city": "Dublin",
 "country": "IE",
 "postCode": "D2",
 "state": "Dublin",
}'

201 Created個人識別情報(PII)に関する回答:

{
 "href":"<baseURL>/v2/guests/f7aabbca-1c1b-4fc2-be72-3e16294a4f03",
 "ref":"f7aabbca-1c1b-4fc2-be72-3e16294a4f03",
 "createdAt":"2026-03-07T16:\`15:11\`.000Z",
 "modifiedAt":"2026-08-23T16:\`17:16\`.000Z",
 "firstSeen":"2026-03-07T16:\`15:11\`.000Z",
 "lastSeen":"2026-08-23T16:\`17:16\`.000Z",
 "guestType":"customer",
 "title": "Ms",
 "firstName": "Jane",
 "lastName": "Doe",
 "gender": "female",
 "dateOfBirth": "1976-10-28T00:\`00:00\`.000Z",
 "emails": 
 "jane.doe@myretailsite.com"
 ,
 "phoneNumbers": 
 "0851234567"
 ,
 "nationality": "Irish",
 "passportNumber": "PZ4A9565",
 "passportExpiry": "2033-01-01T00:\`00:00\`.000Z",
 "street": 
 "Apartment 15",
 "West Drive Avenue"
 ,
 "city": "Dublin",
 "country": "IE",
 "postCode": "D2",
 "state": "Dublin",
}

identifiersを使ってゲストを作成します:

curl -X POST '<baseURL>/v2/guests' \\
-u '<username>:<password>' \\
-H 'Accept: application/json' \\
--data-raw '
 {
 "guestType":"customer",
 "identifiers":
 {
 "provider":"BXLP",
 "id":"123456",
 "expiryDate":"2028-08-23T16:\`17:16\`.000Z"
 }
 
}'

201 Createdidentifiersの回答:

{
 "href":"<baseURL>/v2/guests/f7aabbca-1c1b-4fc2-be72-3e16294a4f03",
 "ref":"f7aabbca-1c1b-4fc2-be72-3e16294a4f03",
 "createdAt":"2026-03-07T16:\`15:11\`.000Z",
 "modifiedAt":"2026-08-23T16:\`17:16\`.000Z",
 "firstSeen":"2026-03-07T16:\`15:11\`.000Z",
 "lastSeen":"2026-08-23T16:\`17:16\`.000Z",
 "guestType":"customer",
 "identifiers":
 {
 "provider":"BXLP",
 "id":"123456",
 "expiryDate":"2028-08-23T16:\`17:16\`.000Z"
 }
 
}

curl -X POST '<baseURL>/v2/guests' \\
-u '<username>:<password>' \\
-H 'Accept: application/json' \\
--data-raw '
 {
 "guestType": "customer",
 "title": "Ms",
 "firstName": "Jane",
 "lastName": "Doe",
 "gender": "female",
 "dateOfBirth": "1976-10-28T00:\`00:00\`.000Z",
 "emails": 
 "jane.doe@myretailsite.com"
 ,
 "phoneNumbers": 
 "0851234567"
 ,
 "nationality": "Irish",
 "passportNumber": "PZ4A9565",
 "passportExpiry": "2033-01-01T00:\`00:00\`.000Z",
 "street": 
 "Apartment 15",
 "West Drive Avenue"
 ,
 "city": "Dublin",
 "country": "IE",
 "postCode": "D2",
 "state": "Dublin",
 "identifiers": 
 {
 "provider":"BXLP",
 "id":"123456",
 "expiryDate":"2028-08-23T16:\`17:16\`.000Z"
 }
 
}'

{
 "href":"<baseURL>/v2/guests/f7aabbca-1c1b-4fc2-be72-3e16294a4f03",
 "ref":"f7aabbca-1c1b-4fc2-be72-3e16294a4f03",
 "createdAt":"2026-03-07T16:\`15:11\`.000Z",
 "modifiedAt":"2026-08-23T16:\`17:16\`.000Z",
 "firstSeen":"2026-03-07T16:\`15:11\`.000Z",
 "lastSeen":"2026-08-23T16:\`17:16\`.000Z",
 "guestType": "customer",
 "title": "Ms",
 "firstName": "Jane",
 "lastName": "Doe",
 "gender": "female",
 "dateOfBirth": "1976-10-28T00:\`00:00\`.000Z",
 "emails": 
 "jane.doe@myretailsite.com"
 ,
 "phoneNumbers": 
 "0851234567"
 ,
 "nationality": "Irish",
 "passportNumber": "PZ4A9565",
 "street": 
 "Apartment 15",
 "West Drive Avenue"
 ,
 "city": "Dublin",
 "country": "Ireland",
 "postCode": "D2",
 "state": "Dublin",
 "identifiers": 
 {
 "provider":"BXLP",
 "id":"123456",
 "expiryDate":"2028-08-23T16:\`17:16\`.000Z"
 }
 
}