Profiles
Guest and customer profiles for wishlist ownership.
Profiles represent a visitor or customer and own wishlist items. Use these endpoints to create or merge profiles. Authentication is required.
Create guest profile
POST /profile/guest
Request
{
"sessionId": "guest-session-id",
"email": "guest@example.com",
"firstName": "Jane",
"lastName": "Doe",
"device": "desktop",
"locale": "en"
}Response
{
"profileId": "cuid...",
"profileType": "guest",
"shop": "example.myshopify.com"
}Parameters
| Field | Type | Required | Description |
|---|---|---|---|
| sessionId | string | yes | Anonymous visitor id. |
| string | no | Optional email. | |
| firstName | string | no | Optional name. |
| lastName | string | no | Optional name. |
| device | string | no | e.g. desktop, mobile. |
| locale | string | no | e.g. en, pl. |
Merge guest into customer
POST /profile/merge
Request
{
"customerId": "8769049329896",
"sessionId": "guest-session-id",
"email": "customer@example.com",
"firstName": "Jane",
"lastName": "Doe",
"device": "desktop",
"locale": "en"
}Response
{
"profileId": "cuid...",
"profileType": "account",
"shop": "example.myshopify.com"
}Parameters
| Field | Type | Required | Description |
|---|---|---|---|
| customerId | string | yes | Numeric Shopify customer id. |
| sessionId | string | no | Guest session id to merge. |
| string | no | Customer email. | |
| firstName | string | no | Customer name. |
| lastName | string | no | Customer name. |
| device | string | no | Device label. |
| locale | string | no | Locale. |