Save the picker (final state)
curl --request PUT \
--url https://{host}/api/v1/products/{productId}/wishlists \
--header 'Content-Type: application/json' \
--header 'X-Shopify-ApiKey: <api-key>' \
--header 'X-Shopify-CustomerId: <api-key>' \
--header 'X-Shopify-Shop: <api-key>' \
--data '
{
"variantId": "44986124009525",
"wishlistIds": [
102,
103
],
"newWishlistNames": [
"my wishlist 0001"
]
}
'const options = {
method: 'PUT',
headers: {
'X-Shopify-ApiKey': '<api-key>',
'X-Shopify-Shop': '<api-key>',
'X-Shopify-CustomerId': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
variantId: '44986124009525',
wishlistIds: [102, 103],
newWishlistNames: ['my wishlist 0001']
})
};
fetch('https://{host}/api/v1/products/{productId}/wishlists', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://{host}/api/v1/products/{productId}/wishlists"
payload = {
"variantId": "44986124009525",
"wishlistIds": [102, 103],
"newWishlistNames": ["my wishlist 0001"]
}
headers = {
"X-Shopify-ApiKey": "<api-key>",
"X-Shopify-Shop": "<api-key>",
"X-Shopify-CustomerId": "<api-key>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)import Foundation
let parameters = [
"variantId": "44986124009525",
"wishlistIds": [102, 103],
"newWishlistNames": ["my wishlist 0001"]
] as [String : Any?]
let postData = try JSONSerialization.data(withJSONObject: parameters, options: [])
let url = URL(string: "https://{host}/api/v1/products/{productId}/wishlists")!
var request = URLRequest(url: url)
request.httpMethod = "PUT"
request.timeoutInterval = 10
request.allHTTPHeaderFields = [
"X-Shopify-ApiKey": "<api-key>",
"X-Shopify-Shop": "<api-key>",
"X-Shopify-CustomerId": "<api-key>",
"Content-Type": "application/json"
]
request.httpBody = postData
let (data, _) = try await URLSession.shared.data(for: request)
print(String(decoding: data, as: UTF8.self))val client = OkHttpClient()
val mediaType = MediaType.parse("application/json")
val body = RequestBody.create(mediaType, "{\n \"variantId\": \"44986124009525\",\n \"wishlistIds\": [\n 102,\n 103\n ],\n \"newWishlistNames\": [\n \"my wishlist 0001\"\n ]\n}")
val request = Request.Builder()
.url("https://{host}/api/v1/products/{productId}/wishlists")
.put(body)
.addHeader("X-Shopify-ApiKey", "<api-key>")
.addHeader("X-Shopify-Shop", "<api-key>")
.addHeader("X-Shopify-CustomerId", "<api-key>")
.addHeader("Content-Type", "application/json")
.build()
val response = client.newCall(request).execute(){
"data": [
{
"id": 102,
"name": "Birthday picks",
"containsProduct": true
},
{
"id": 98,
"name": "Old list",
"containsProduct": false
},
{
"id": 115,
"name": "my wishlist 0001",
"containsProduct": true
}
],
"meta": {
"created": [
{
"id": 115,
"name": "my wishlist 0001"
}
],
"added": [
115
],
"removed": [
98
]
},
"message": "Wishlist items updated successfully",
"messageKey": "error_wishlist_items_updated_successfully"
}{
"title": "Malformed request",
"status": 400,
"code": "MALFORMED_REQUEST",
"message": "wishlistId must be a number.",
"messageKey": null
}{
"title": "Unauthenticated",
"status": 401,
"code": "UNAUTHENTICATED",
"message": "Invalid API Key",
"messageKey": null
}{
"title": "Guest disabled",
"status": 403,
"code": "GUEST_DISABLED",
"message": "Please log in to save items to your wishlist.",
"messageKey": "error_guest_login_required"
}{
"title": "Wishlist not found",
"status": 404,
"code": "WISHLIST_NOT_FOUND",
"message": "Wishlist not found",
"messageKey": "error_wishlist_not_found"
}{
"title": "Wishlist name taken",
"status": 409,
"code": "WISHLIST_NAME_TAKEN",
"message": "A wishlist with this name already exists",
"messageKey": "error_wishlist_name_already_exists"
}{
"title": "Version retired",
"status": 410,
"code": "VERSION_RETIRED",
"message": "Please update the app to continue.",
"messageKey": "error_app_update_required"
}{
"title": "Validation failed",
"status": 422,
"code": "VALIDATION_FAILED",
"message": "name is required.",
"messageKey": null,
"errors": [
{
"field": "name",
"message": "name is required."
}
]
}{
"title": "Rate limited",
"status": 429,
"code": "RATE_LIMITED",
"message": "Too many requests. Please try again in a minute.",
"messageKey": "error_too_many_requests"
}{
"title": "Internal error",
"status": 500,
"code": "INTERNAL_ERROR",
"message": "Something went wrong. Please try again.",
"messageKey": "error_something_went_wrong"
}Product
Save the picker (final state)
PUT
/
products
/
{productId}
/
wishlists
Save the picker (final state)
curl --request PUT \
--url https://{host}/api/v1/products/{productId}/wishlists \
--header 'Content-Type: application/json' \
--header 'X-Shopify-ApiKey: <api-key>' \
--header 'X-Shopify-CustomerId: <api-key>' \
--header 'X-Shopify-Shop: <api-key>' \
--data '
{
"variantId": "44986124009525",
"wishlistIds": [
102,
103
],
"newWishlistNames": [
"my wishlist 0001"
]
}
'const options = {
method: 'PUT',
headers: {
'X-Shopify-ApiKey': '<api-key>',
'X-Shopify-Shop': '<api-key>',
'X-Shopify-CustomerId': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
variantId: '44986124009525',
wishlistIds: [102, 103],
newWishlistNames: ['my wishlist 0001']
})
};
fetch('https://{host}/api/v1/products/{productId}/wishlists', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://{host}/api/v1/products/{productId}/wishlists"
payload = {
"variantId": "44986124009525",
"wishlistIds": [102, 103],
"newWishlistNames": ["my wishlist 0001"]
}
headers = {
"X-Shopify-ApiKey": "<api-key>",
"X-Shopify-Shop": "<api-key>",
"X-Shopify-CustomerId": "<api-key>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)import Foundation
let parameters = [
"variantId": "44986124009525",
"wishlistIds": [102, 103],
"newWishlistNames": ["my wishlist 0001"]
] as [String : Any?]
let postData = try JSONSerialization.data(withJSONObject: parameters, options: [])
let url = URL(string: "https://{host}/api/v1/products/{productId}/wishlists")!
var request = URLRequest(url: url)
request.httpMethod = "PUT"
request.timeoutInterval = 10
request.allHTTPHeaderFields = [
"X-Shopify-ApiKey": "<api-key>",
"X-Shopify-Shop": "<api-key>",
"X-Shopify-CustomerId": "<api-key>",
"Content-Type": "application/json"
]
request.httpBody = postData
let (data, _) = try await URLSession.shared.data(for: request)
print(String(decoding: data, as: UTF8.self))val client = OkHttpClient()
val mediaType = MediaType.parse("application/json")
val body = RequestBody.create(mediaType, "{\n \"variantId\": \"44986124009525\",\n \"wishlistIds\": [\n 102,\n 103\n ],\n \"newWishlistNames\": [\n \"my wishlist 0001\"\n ]\n}")
val request = Request.Builder()
.url("https://{host}/api/v1/products/{productId}/wishlists")
.put(body)
.addHeader("X-Shopify-ApiKey", "<api-key>")
.addHeader("X-Shopify-Shop", "<api-key>")
.addHeader("X-Shopify-CustomerId", "<api-key>")
.addHeader("Content-Type", "application/json")
.build()
val response = client.newCall(request).execute(){
"data": [
{
"id": 102,
"name": "Birthday picks",
"containsProduct": true
},
{
"id": 98,
"name": "Old list",
"containsProduct": false
},
{
"id": 115,
"name": "my wishlist 0001",
"containsProduct": true
}
],
"meta": {
"created": [
{
"id": 115,
"name": "my wishlist 0001"
}
],
"added": [
115
],
"removed": [
98
]
},
"message": "Wishlist items updated successfully",
"messageKey": "error_wishlist_items_updated_successfully"
}{
"title": "Malformed request",
"status": 400,
"code": "MALFORMED_REQUEST",
"message": "wishlistId must be a number.",
"messageKey": null
}{
"title": "Unauthenticated",
"status": 401,
"code": "UNAUTHENTICATED",
"message": "Invalid API Key",
"messageKey": null
}{
"title": "Guest disabled",
"status": 403,
"code": "GUEST_DISABLED",
"message": "Please log in to save items to your wishlist.",
"messageKey": "error_guest_login_required"
}{
"title": "Wishlist not found",
"status": 404,
"code": "WISHLIST_NOT_FOUND",
"message": "Wishlist not found",
"messageKey": "error_wishlist_not_found"
}{
"title": "Wishlist name taken",
"status": 409,
"code": "WISHLIST_NAME_TAKEN",
"message": "A wishlist with this name already exists",
"messageKey": "error_wishlist_name_already_exists"
}{
"title": "Version retired",
"status": 410,
"code": "VERSION_RETIRED",
"message": "Please update the app to continue.",
"messageKey": "error_app_update_required"
}{
"title": "Validation failed",
"status": 422,
"code": "VALIDATION_FAILED",
"message": "name is required.",
"messageKey": null,
"errors": [
{
"field": "name",
"message": "name is required."
}
]
}{
"title": "Rate limited",
"status": 429,
"code": "RATE_LIMITED",
"message": "Too many requests. Please try again in a minute.",
"messageKey": "error_too_many_requests"
}{
"title": "Internal error",
"status": 500,
"code": "INTERNAL_ERROR",
"message": "Something went wrong. Please try again.",
"messageKey": "error_something_went_wrong"
}Authorizations
ApiKey & Shop & CustomerIdApiKey & Shop & SessionId
Store API key from Wishlist settings > API Settings.
The store's myshopify domain, e.g. your-store.myshopify.com.
Numeric Shopify customer id of a logged-in shopper. Verified against the store on every call.
Path Parameters
Numeric Shopify product id.
Pattern:
^\d+$Body
application/json
Response
Resulting state of every list