Wishlists

These endpoints are called from a shopper's browser, so they take your publishable key rather than a secret one. Anything specific to one customer also takes a signed email and timestamp. Identifying the customer explains how to produce the signature.

To call them from your own server instead, send a secret key as a bearer token and leave apiPublishableKey out. See Calling the widget API from a server.

GET `/widgets/wishlists/for-product`

List the current customer's wishlists plus whether each contains a product. The customer parameters are optional here: with the publishable key alone it returns the store's wishlist settings and an empty list, which is how the widget renders for a shopper who is not signed in

Query parameters

apiPublishableKeystring

Your organization's publishable key, from Settings, API keys. Leave it out when the request carries a secret key as a bearer token instead, which is how a server calls these endpoints.

customerEmailstring (email)

The signed-in shopper's address. Leave it out for a shopper who is not signed in.

timestampstring

The Unix seconds the signature was made at. Required with customerEmail.

signaturestring

The HMAC of the email and timestamp. Required with customerEmail.

productSlugstring

Slug of the product. Send this or productExternalId.

productExternalIdstring

The product's ID on one of your sites, such as its Shopify product ID, sent instead of productSlug. Either Shopify form works.

sitestring

The slug of the site productExternalId belongs to. Only needed when the same ID is on more than one of your sites.

Request

curl \
  "https://your-store.meisei.app/api/widgets/wishlists/for-product?apiPublishableKey=pk_YOUR_PUBLISHABLE_KEY"

Request

import { client } from "@meisei/api/widget/client"
import { getWidgetsWishlistsForProduct } from "@meisei/api/widget"

client.setConfig({
  baseUrl: "https://your-store.meisei.app/api",
})

const { data, error } = await getWidgetsWishlistsForProduct({
  query: { apiPublishableKey: "pk_YOUR_PUBLISHABLE_KEY" },
})

Request

require "meisei"

meisei = Meisei::WidgetClient.new(
  publishable_key: "pk_YOUR_PUBLISHABLE_KEY",
  base_url: "https://your-store.meisei.app/api",
)

result = meisei.wishlists.for_product

Request

from meisei import WidgetClient

meisei = WidgetClient(
    publishable_key="pk_YOUR_PUBLISHABLE_KEY",
    base_url="https://your-store.meisei.app/api",
)

result = meisei.wishlists.for_product()

Response

{
  "productSlug": "string",
  "productFound": true,
  "wishlists": [
    {
      "id": "A4Ws1igz",
      "name": "string",
      "itemsCount": 0,
      "shared": true,
      "shareUrl": "https://example.com",
      "shareToken": "string",
      "isDefault": true,
      "createdAt": "2025-01-15T09:30:00Z",
      "updatedAt": "2025-01-15T09:30:00Z",
      "hasProduct": true,
      "productItemId": "A4Ws1igz"
    }
  ],
  "sharingEnabled": true,
  "multipleWishlists": true,
  "itemImagesEnabled": true,
  "defaultWishlistName": "string"
}

Response schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "productSlug": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "The product's slug, which is how the other wishlist calls name it. Null when `productExternalId` matched no product."
    },
    "productFound": {
      "type": "boolean"
    },
    "wishlists": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique identifier for the wishlist.",
            "idCodec": "sqid"
          },
          "name": {
            "type": "string"
          },
          "itemsCount": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "shared": {
            "type": "boolean",
            "description": "Whether anyone with the share link can view the wishlist."
          },
          "shareUrl": {
            "type": "string",
            "format": "uri",
            "description": "The public link to the wishlist. It only works while the wishlist is shared."
          },
          "shareToken": {
            "type": "string",
            "description": "The token in the share link, for building a product link that opens with the shopper's photo and note: `?meiseiWishlist=<shareToken>&meiseiItem=<itemId>`. Only meaningful while the wishlist is shared."
          },
          "isDefault": {
            "type": "boolean",
            "description": "Whether this is the customer's default wishlist, the one one-click saves go to."
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
          },
          "hasProduct": {
            "type": "boolean"
          },
          "productItemId": {
            "anyOf": [
              {
                "type": "string",
                "description": "The item this product is saved as, or null.",
                "idCodec": "sqid"
              },
              {
                "type": "null"
              }
            ],
            "description": "The item this product is saved as, or null."
          }
        },
        "required": [
          "id",
          "name",
          "itemsCount",
          "shared",
          "shareUrl",
          "shareToken",
          "isDefault",
          "createdAt",
          "updatedAt",
          "hasProduct",
          "productItemId"
        ],
        "additionalProperties": false
      }
    },
    "sharingEnabled": {
      "type": "boolean",
      "description": "Whether this store allows wishlist sharing at all. When false, hide every share control."
    },
    "multipleWishlists": {
      "type": "boolean",
      "description": "Whether this store lets a customer keep several wishlists. When false, everything they save goes on one list, so hide the controls for creating or naming another. Lists a customer already holds keep working either way."
    },
    "itemImagesEnabled": {
      "type": "boolean",
      "description": "Whether this store lets a signed-in customer attach their own photo to a saved item. When false, hide the photo picker; any photo already on an item comes back as null."
    },
    "defaultWishlistName": {
      "type": "string",
      "description": "The name this store gives a customer's first wishlist. A customer with no lists yet is shown one empty list under this name; nothing is saved until they use it."
    }
  },
  "required": [
    "productSlug",
    "productFound",
    "wishlists",
    "sharingEnabled",
    "multipleWishlists",
    "itemImagesEnabled",
    "defaultWishlistName"
  ],
  "additionalProperties": false
}

POST `/widgets/wishlists/claim`

Move the lists a shopper saved in their browser before signing in onto their customer record. When the store allows several lists, each browser list becomes a new wishlist and a name that is already taken gets a numbered suffix. When it keeps one list per customer, everything flattens into the default list. An item already on the target list is left exactly as it is. The whole claim succeeds or fails together, so the browser can keep its copy until the response confirms the merge

Query parameters

apiPublishableKeystring

Your organization's publishable key, from Settings, API keys. Leave it out when the request carries a secret key as a bearer token instead, which is how a server calls these endpoints.

customerEmailstring (email)required

Email address of the customer the storefront signed in.

timestampstringrequired

Unix time in seconds when the signature was generated. It is accepted for 24 hours.

signaturestringrequired

Hex HMAC-SHA256 of customerEmail followed by timestamp, keyed with your widget signing secret. See the widgets guide for the recipe.

Body parameters

listsobject[]required

The lists the shopper built in their browser before signing in.

Request

curl \
  -X POST \
  "https://your-store.meisei.app/api/widgets/wishlists/claim?apiPublishableKey=pk_YOUR_PUBLISHABLE_KEY&customerEmail=shopper%40example.com&timestamp=1735689600&signature=9f86d081..." \
  -H "Content-Type: application/json" \
  -d '{
  "lists": [
    {
      "name": "string",
      "items": [
        "..."
      ]
    }
  ]
}'

Request

import { client } from "@meisei/api/widget/client"
import { postWidgetsWishlistsClaim } from "@meisei/api/widget"

client.setConfig({
  baseUrl: "https://your-store.meisei.app/api",
})

const { data, error } = await postWidgetsWishlistsClaim({
  query: {
    apiPublishableKey: "pk_YOUR_PUBLISHABLE_KEY",
    customerEmail: "shopper@example.com",
    timestamp: "1735689600",
    signature: "9f86d081...",
  },
  body: {
    lists: [
      {
        name: "string",
        items: ["..."],
      },
    ],
  },
})

Request

require "meisei"

meisei = Meisei::WidgetClient.new(
  publishable_key: "pk_YOUR_PUBLISHABLE_KEY",
  base_url: "https://your-store.meisei.app/api",
)

result = meisei.wishlists.claim(
  customer_email: "shopper@example.com",
  timestamp: "1735689600",
  signature: "9f86d081...",
  lists: [{ name: "string", items: ["..."] }],
)

Request

from meisei import WidgetClient

meisei = WidgetClient(
    publishable_key="pk_YOUR_PUBLISHABLE_KEY",
    base_url="https://your-store.meisei.app/api",
)

result = meisei.wishlists.claim(
    customer_email="shopper@example.com",
    timestamp="1735689600",
    signature="9f86d081...",
    lists=[{"name": "string", "items": []}],
)

Response

{
  "wishlists": [
    {
      "id": "A4Ws1igz",
      "name": "string",
      "itemsCount": 0,
      "shared": true,
      "shareUrl": "https://example.com",
      "shareToken": "string",
      "isDefault": true,
      "createdAt": "2025-01-15T09:30:00Z",
      "updatedAt": "2025-01-15T09:30:00Z"
    }
  ],
  "sharingEnabled": true,
  "multipleWishlists": true,
  "itemImagesEnabled": true,
  "claimedLists": 0,
  "claimedItems": 0,
  "skippedItems": 0
}

Response schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "wishlists": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique identifier for the wishlist.",
            "idCodec": "sqid"
          },
          "name": {
            "type": "string"
          },
          "itemsCount": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "shared": {
            "type": "boolean",
            "description": "Whether anyone with the share link can view the wishlist."
          },
          "shareUrl": {
            "type": "string",
            "format": "uri",
            "description": "The public link to the wishlist. It only works while the wishlist is shared."
          },
          "shareToken": {
            "type": "string",
            "description": "The token in the share link, for building a product link that opens with the shopper's photo and note: `?meiseiWishlist=<shareToken>&meiseiItem=<itemId>`. Only meaningful while the wishlist is shared."
          },
          "isDefault": {
            "type": "boolean",
            "description": "Whether this is the customer's default wishlist, the one one-click saves go to."
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
          }
        },
        "required": [
          "id",
          "name",
          "itemsCount",
          "shared",
          "shareUrl",
          "shareToken",
          "isDefault",
          "createdAt",
          "updatedAt"
        ],
        "additionalProperties": false
      },
      "description": "Every wishlist the customer holds after the claim."
    },
    "sharingEnabled": {
      "type": "boolean",
      "description": "Whether this store allows wishlist sharing at all. When false, hide every share control."
    },
    "multipleWishlists": {
      "type": "boolean",
      "description": "Whether this store lets a customer keep several wishlists. When false, everything they save goes on one list, so hide the controls for creating or naming another. Lists a customer already holds keep working either way."
    },
    "itemImagesEnabled": {
      "type": "boolean",
      "description": "Whether this store lets a signed-in customer attach their own photo to a saved item. When false, hide the photo picker; any photo already on an item comes back as null."
    },
    "claimedLists": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "How many new wishlists the claim created."
    },
    "claimedItems": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "How many items the claim added."
    },
    "skippedItems": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "Items that were not added: already on the target list, repeated in the payload, or naming a product this store no longer has."
    }
  },
  "required": [
    "wishlists",
    "sharingEnabled",
    "multipleWishlists",
    "itemImagesEnabled",
    "claimedLists",
    "claimedItems",
    "skippedItems"
  ],
  "additionalProperties": false
}

POST `/widgets/wishlists/upload-url`

Get a link to upload a customer's own photo of a saved item. PUT the file's bytes to uploadUrl, then send key as imageKey when updating the item. Photos only, at most 5 MB, checked again once the bytes land. Refused while the store has photos on saved items switched off. Rate limited per address

Query parameters

apiPublishableKeystring

Your organization's publishable key, from Settings, API keys. Leave it out when the request carries a secret key as a bearer token instead, which is how a server calls these endpoints.

customerEmailstring (email)required

Email address of the customer the storefront signed in.

timestampstringrequired

Unix time in seconds when the signature was generated. It is accepted for 24 hours.

signaturestringrequired

Hex HMAC-SHA256 of customerEmail followed by timestamp, keyed with your widget signing secret. See the widgets guide for the recipe.

Body parameters

fileNamestringrequired

The file's name, kept for the dashboard.

contentTypeimage/jpeg | image/png | image/webp | image/gifrequired

The file's MIME type. Photos only: JPEG, PNG, WebP or GIF.

sizeBytesnumberrequired

The file's size in bytes. Photos can be at most 5 MB.

Request

curl \
  -X POST \
  "https://your-store.meisei.app/api/widgets/wishlists/upload-url?apiPublishableKey=pk_YOUR_PUBLISHABLE_KEY&customerEmail=shopper%40example.com&timestamp=1735689600&signature=9f86d081..." \
  -H "Content-Type: application/json" \
  -d '{
  "fileName": "string",
  "contentType": "image/jpeg",
  "sizeBytes": 0
}'

Request

import { client } from "@meisei/api/widget/client"
import { postWidgetsWishlistsUploadUrl } from "@meisei/api/widget"

client.setConfig({
  baseUrl: "https://your-store.meisei.app/api",
})

const { data, error } = await postWidgetsWishlistsUploadUrl({
  query: {
    apiPublishableKey: "pk_YOUR_PUBLISHABLE_KEY",
    customerEmail: "shopper@example.com",
    timestamp: "1735689600",
    signature: "9f86d081...",
  },
  body: {
    fileName: "string",
    contentType: "image/jpeg",
    sizeBytes: 0,
  },
})

Request

require "meisei"

meisei = Meisei::WidgetClient.new(
  publishable_key: "pk_YOUR_PUBLISHABLE_KEY",
  base_url: "https://your-store.meisei.app/api",
)

result = meisei.wishlists.upload_url(
  customer_email: "shopper@example.com",
  timestamp: "1735689600",
  signature: "9f86d081...",
  file_name: "string",
  content_type: "image/jpeg",
  size_bytes: 0,
)

Request

from meisei import WidgetClient

meisei = WidgetClient(
    publishable_key="pk_YOUR_PUBLISHABLE_KEY",
    base_url="https://your-store.meisei.app/api",
)

result = meisei.wishlists.upload_url(
    customer_email="shopper@example.com",
    timestamp="1735689600",
    signature="9f86d081...",
    file_name="string",
    content_type="image/jpeg",
    size_bytes=0,
)

Response

{
  "key": "string",
  "uploadUrl": "string",
  "expiresAt": "2025-01-15T09:30:00Z"
}

Response schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "key": {
      "type": "string",
      "description": "Send this back as `imageKey` when you update the item. Nothing is shown until you do."
    },
    "uploadUrl": {
      "type": "string",
      "description": "PUT the file's bytes here. The link is good for five minutes."
    },
    "expiresAt": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
      "description": "When the upload link stops working."
    }
  },
  "required": ["key", "uploadUrl", "expiresAt"],
  "additionalProperties": false
}

GET `/widgets/wishlists/banner`

What a product page shows when somebody arrives from a shared wishlist link carrying meiseiWishlist and meiseiItem: the shopper's photo and note for that item, whose list it is, and a link to the whole list. No customer signature is needed. The answer is null whenever there is nothing to show: the list is private or sharing is off, the item is not this product, or it carries neither a photo nor a note

Query parameters

apiPublishableKeystring

Your organization's publishable key, from Settings, API keys. Leave it out when the request carries a secret key as a bearer token instead, which is how a server calls these endpoints.

shareTokenstringrequired

The meiseiWishlist value from the link the shopper arrived on.

itemIdstringrequired

The meiseiItem value from the same link.

productSlugstring

Slug of the product the page is showing. The banner only answers for a match. Send this or productExternalId.

productExternalIdstring

The product's ID on one of your sites, such as its Shopify product ID, sent instead of productSlug. Either Shopify form works.

sitestring

The slug of the site productExternalId belongs to. Only needed when the same ID is on more than one of your sites.

Request

curl \
  "https://your-store.meisei.app/api/widgets/wishlists/banner?apiPublishableKey=pk_YOUR_PUBLISHABLE_KEY&shareToken=string&itemId=A4Ws1igz"

Request

import { client } from "@meisei/api/widget/client"
import { getWidgetsWishlistsBanner } from "@meisei/api/widget"

client.setConfig({
  baseUrl: "https://your-store.meisei.app/api",
})

const { data, error } = await getWidgetsWishlistsBanner({
  query: { apiPublishableKey: "pk_YOUR_PUBLISHABLE_KEY", shareToken: "string", itemId: "A4Ws1igz" },
})

Request

require "meisei"

meisei = Meisei::WidgetClient.new(
  publishable_key: "pk_YOUR_PUBLISHABLE_KEY",
  base_url: "https://your-store.meisei.app/api",
)

result = meisei.wishlists.banner(share_token: "string", item_id: "A4Ws1igz")

Request

from meisei import WidgetClient

meisei = WidgetClient(
    publishable_key="pk_YOUR_PUBLISHABLE_KEY",
    base_url="https://your-store.meisei.app/api",
)

result = meisei.wishlists.banner(share_token="string", item_id="A4Ws1igz")

Response

{
  "banner": {
    "imageUrl": "string",
    "note": "string",
    "ownerFirstName": "string",
    "wishlistName": "string",
    "shareUrl": "https://example.com"
  }
}

Response schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "banner": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "imageUrl": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "The shopper's own photo of the item, or null if they added none or photos are off."
            },
            "note": {
              "type": "string",
              "description": "The shopper's note about the item, or an empty string."
            },
            "ownerFirstName": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "The list owner's first name for display, or null if they have none on file."
            },
            "wishlistName": {
              "type": "string",
              "description": "The wishlist's name, as the shopper typed it."
            },
            "shareUrl": {
              "type": "string",
              "format": "uri",
              "description": "The public link to the whole list."
            }
          },
          "required": ["imageUrl", "note", "ownerFirstName", "wishlistName", "shareUrl"],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ],
      "description": "What to show, or null when there is nothing to show: the list is private, the item is not this product, or it carries neither a photo nor a note."
    }
  },
  "required": ["banner"],
  "additionalProperties": false
}

POST `/widgets/wishlists/default/toggle-item`

Toggle a product on the customer's default wishlist, creating the default list on first use

Query parameters

apiPublishableKeystring

Your organization's publishable key, from Settings, API keys. Leave it out when the request carries a secret key as a bearer token instead, which is how a server calls these endpoints.

customerEmailstring (email)required

Email address of the customer the storefront signed in.

timestampstringrequired

Unix time in seconds when the signature was generated. It is accepted for 24 hours.

signaturestringrequired

Hex HMAC-SHA256 of customerEmail followed by timestamp, keyed with your widget signing secret. See the widgets guide for the recipe.

Body parameters

productSlugstring

Slug of the product. Send this or productExternalId.

productExternalIdstring

The product's ID on one of your sites, such as its Shopify product ID, sent instead of productSlug. Either Shopify form works.

sitestring

The slug of the site productExternalId belongs to. Only needed when the same ID is on more than one of your sites.

Request

curl \
  -X POST \
  "https://your-store.meisei.app/api/widgets/wishlists/default/toggle-item?apiPublishableKey=pk_YOUR_PUBLISHABLE_KEY&customerEmail=shopper%40example.com&timestamp=1735689600&signature=9f86d081..." \
  -H "Content-Type: application/json" \
  -d '{
  "productSlug": "string",
  "productExternalId": "string",
  "site": "string"
}'

Request

import { client } from "@meisei/api/widget/client"
import { postWidgetsWishlistsDefaultToggleItem } from "@meisei/api/widget"

client.setConfig({
  baseUrl: "https://your-store.meisei.app/api",
})

const { data, error } = await postWidgetsWishlistsDefaultToggleItem({
  query: {
    apiPublishableKey: "pk_YOUR_PUBLISHABLE_KEY",
    customerEmail: "shopper@example.com",
    timestamp: "1735689600",
    signature: "9f86d081...",
  },
  body: {
    productSlug: "string",
    productExternalId: "string",
    site: "string",
  },
})

Request

require "meisei"

meisei = Meisei::WidgetClient.new(
  publishable_key: "pk_YOUR_PUBLISHABLE_KEY",
  base_url: "https://your-store.meisei.app/api",
)

result = meisei.wishlists.default.toggle_item(
  customer_email: "shopper@example.com",
  timestamp: "1735689600",
  signature: "9f86d081...",
  product_slug: "string",
  product_external_id: "string",
  site: "string",
)

Request

from meisei import WidgetClient

meisei = WidgetClient(
    publishable_key="pk_YOUR_PUBLISHABLE_KEY",
    base_url="https://your-store.meisei.app/api",
)

result = meisei.wishlists.default.toggle_item(
    customer_email="shopper@example.com",
    timestamp="1735689600",
    signature="9f86d081...",
    product_slug="string",
    product_external_id="string",
    site="string",
)

Response

{
  "wishlist": {
    "id": "A4Ws1igz",
    "name": "string",
    "itemsCount": 0,
    "shared": true,
    "shareUrl": "https://example.com",
    "shareToken": "string",
    "isDefault": true,
    "createdAt": "2025-01-15T09:30:00Z",
    "updatedAt": "2025-01-15T09:30:00Z",
    "items": [
      {
        "id": "...",
        "productId": "...",
        "productVariantId": "...",
        "quantity": "...",
        "note": "...",
        "imageUrl": "...",
        "purchasedQuantity": "...",
        "createdAt": "...",
        "product": "...",
        "variant": "..."
      }
    ]
  },
  "added": true,
  "sharingEnabled": true,
  "multipleWishlists": true,
  "itemImagesEnabled": true
}

Response schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "wishlist": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "Unique identifier for the wishlist.",
          "idCodec": "sqid"
        },
        "name": {
          "type": "string"
        },
        "itemsCount": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "shared": {
          "type": "boolean",
          "description": "Whether anyone with the share link can view the wishlist."
        },
        "shareUrl": {
          "type": "string",
          "format": "uri",
          "description": "The public link to the wishlist. It only works while the wishlist is shared."
        },
        "shareToken": {
          "type": "string",
          "description": "The token in the share link, for building a product link that opens with the shopper's photo and note: `?meiseiWishlist=<shareToken>&meiseiItem=<itemId>`. Only meaningful while the wishlist is shared."
        },
        "isDefault": {
          "type": "boolean",
          "description": "Whether this is the customer's default wishlist, the one one-click saves go to."
        },
        "createdAt": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
        },
        "updatedAt": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
        },
        "items": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "Unique identifier for the wishlist item.",
                "idCodec": "sqid"
              },
              "productId": {
                "type": "string",
                "description": "The product saved to the wishlist.",
                "idCodec": "sqid"
              },
              "productVariantId": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "The variant saved, or null for the product as a whole.",
                    "idCodec": "sqid"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "The variant saved, or null for the product as a whole."
              },
              "quantity": {
                "anyOf": [
                  {
                    "type": "integer",
                    "minimum": -9007199254740991,
                    "maximum": 9007199254740991
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "How many of this item the customer wants, or null if they did not say."
              },
              "note": {
                "type": "string",
                "description": "The customer's note about this item, such as a size or color preference."
              },
              "imageUrl": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "The customer's own photo of the item, to show in place of the product image, or null if they added none or the store has photos switched off."
              },
              "purchasedQuantity": {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991,
                "description": "How many of this item the customer has bought themselves."
              },
              "createdAt": {
                "type": "string",
                "format": "date-time",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
              },
              "product": {
                "type": "object",
                "properties": {
                  "slug": {
                    "type": "string"
                  },
                  "title": {
                    "type": "string"
                  },
                  "imageUrl": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "url": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "URL of the product's page on the storefront, or null if it is not known."
                  },
                  "metadata": {
                    "type": "object",
                    "propertyNames": {
                      "type": "string"
                    },
                    "additionalProperties": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "number"
                        },
                        {
                          "type": "boolean"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ],
                      "description": "A metadata value: a string, a number, true or false, or a list of strings. A key with a metadata definition holds the type its definition names."
                    },
                    "description": "The record's custom fields that are shown on the storefront, keyed by field key. Only fields with `storefront` switched on in `/metadata-definitions` appear, and a field with no value is left out."
                  }
                },
                "required": ["slug", "title", "imageUrl", "url", "metadata"],
                "additionalProperties": false
              },
              "variant": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string",
                        "description": "Unique identifier for the variant.",
                        "idCodec": "sqid"
                      },
                      "slug": {
                        "type": "string"
                      },
                      "title": {
                        "type": "string"
                      },
                      "metadata": {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "array",
                              "items": {
                                "type": "string"
                              }
                            }
                          ],
                          "description": "A metadata value: a string, a number, true or false, or a list of strings. A key with a metadata definition holds the type its definition names."
                        },
                        "description": "The record's custom fields that are shown on the storefront, keyed by field key. Only fields with `storefront` switched on in `/metadata-definitions` appear, and a field with no value is left out."
                      }
                    },
                    "required": ["id", "slug", "title", "metadata"],
                    "additionalProperties": false
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "required": [
              "id",
              "productId",
              "productVariantId",
              "quantity",
              "note",
              "imageUrl",
              "purchasedQuantity",
              "createdAt",
              "product",
              "variant"
            ],
            "additionalProperties": false
          }
        }
      },
      "required": [
        "id",
        "name",
        "itemsCount",
        "shared",
        "shareUrl",
        "shareToken",
        "isDefault",
        "createdAt",
        "updatedAt",
        "items"
      ],
      "additionalProperties": false
    },
    "added": {
      "type": "boolean",
      "description": "True when the toggle put the product on the list, false when it took it off."
    },
    "sharingEnabled": {
      "type": "boolean",
      "description": "Whether this store allows wishlist sharing at all. When false, hide every share control."
    },
    "multipleWishlists": {
      "type": "boolean",
      "description": "Whether this store lets a customer keep several wishlists. When false, everything they save goes on one list, so hide the controls for creating or naming another. Lists a customer already holds keep working either way."
    },
    "itemImagesEnabled": {
      "type": "boolean",
      "description": "Whether this store lets a signed-in customer attach their own photo to a saved item. When false, hide the photo picker; any photo already on an item comes back as null."
    }
  },
  "required": ["wishlist", "added", "sharingEnabled", "multipleWishlists", "itemImagesEnabled"],
  "additionalProperties": false
}

GET `/widgets/wishlists`

List the current customer's wishlists. The customer parameters are optional here: with the publishable key alone it returns the store's wishlist settings and an empty list, which is how the widget renders for a shopper who is not signed in

Query parameters

apiPublishableKeystring

Your organization's publishable key, from Settings, API keys. Leave it out when the request carries a secret key as a bearer token instead, which is how a server calls these endpoints.

customerEmailstring (email)

The signed-in shopper's address. Leave it out for a shopper who is not signed in.

timestampstring

The Unix seconds the signature was made at. Required with customerEmail.

signaturestring

The HMAC of the email and timestamp. Required with customerEmail.

Request

curl \
  "https://your-store.meisei.app/api/widgets/wishlists?apiPublishableKey=pk_YOUR_PUBLISHABLE_KEY"

Request

import { client } from "@meisei/api/widget/client"
import { getWidgetsWishlists } from "@meisei/api/widget"

client.setConfig({
  baseUrl: "https://your-store.meisei.app/api",
})

const { data, error } = await getWidgetsWishlists({
  query: { apiPublishableKey: "pk_YOUR_PUBLISHABLE_KEY" },
})

Request

require "meisei"

meisei = Meisei::WidgetClient.new(
  publishable_key: "pk_YOUR_PUBLISHABLE_KEY",
  base_url: "https://your-store.meisei.app/api",
)

page = meisei.wishlists.list

Request

from meisei import WidgetClient

meisei = WidgetClient(
    publishable_key="pk_YOUR_PUBLISHABLE_KEY",
    base_url="https://your-store.meisei.app/api",
)

page = meisei.wishlists.list()

Response

{
  "wishlists": [
    {
      "id": "A4Ws1igz",
      "name": "string",
      "itemsCount": 0,
      "shared": true,
      "shareUrl": "https://example.com",
      "shareToken": "string",
      "isDefault": true,
      "createdAt": "2025-01-15T09:30:00Z",
      "updatedAt": "2025-01-15T09:30:00Z"
    }
  ],
  "sharingEnabled": true,
  "multipleWishlists": true,
  "itemImagesEnabled": true,
  "defaultWishlistName": "string"
}

Response schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "wishlists": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique identifier for the wishlist.",
            "idCodec": "sqid"
          },
          "name": {
            "type": "string"
          },
          "itemsCount": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "shared": {
            "type": "boolean",
            "description": "Whether anyone with the share link can view the wishlist."
          },
          "shareUrl": {
            "type": "string",
            "format": "uri",
            "description": "The public link to the wishlist. It only works while the wishlist is shared."
          },
          "shareToken": {
            "type": "string",
            "description": "The token in the share link, for building a product link that opens with the shopper's photo and note: `?meiseiWishlist=<shareToken>&meiseiItem=<itemId>`. Only meaningful while the wishlist is shared."
          },
          "isDefault": {
            "type": "boolean",
            "description": "Whether this is the customer's default wishlist, the one one-click saves go to."
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
          }
        },
        "required": [
          "id",
          "name",
          "itemsCount",
          "shared",
          "shareUrl",
          "shareToken",
          "isDefault",
          "createdAt",
          "updatedAt"
        ],
        "additionalProperties": false
      }
    },
    "sharingEnabled": {
      "type": "boolean",
      "description": "Whether this store allows wishlist sharing at all. When false, hide every share control."
    },
    "multipleWishlists": {
      "type": "boolean",
      "description": "Whether this store lets a customer keep several wishlists. When false, everything they save goes on one list, so hide the controls for creating or naming another. Lists a customer already holds keep working either way."
    },
    "itemImagesEnabled": {
      "type": "boolean",
      "description": "Whether this store lets a signed-in customer attach their own photo to a saved item. When false, hide the photo picker; any photo already on an item comes back as null."
    },
    "defaultWishlistName": {
      "type": "string",
      "description": "The name this store gives a customer's first wishlist. A customer with no lists yet is shown one empty list under this name; nothing is saved until they use it."
    }
  },
  "required": [
    "wishlists",
    "sharingEnabled",
    "multipleWishlists",
    "itemImagesEnabled",
    "defaultWishlistName"
  ],
  "additionalProperties": false
}

POST `/widgets/wishlists`

Create a new wishlist

Query parameters

apiPublishableKeystring

Your organization's publishable key, from Settings, API keys. Leave it out when the request carries a secret key as a bearer token instead, which is how a server calls these endpoints.

customerEmailstring (email)required

Email address of the customer the storefront signed in.

timestampstringrequired

Unix time in seconds when the signature was generated. It is accepted for 24 hours.

signaturestringrequired

Hex HMAC-SHA256 of customerEmail followed by timestamp, keyed with your widget signing secret. See the widgets guide for the recipe.

Body parameters

namestringrequired

What the customer called the wishlist.

Request

curl \
  -X POST \
  "https://your-store.meisei.app/api/widgets/wishlists?apiPublishableKey=pk_YOUR_PUBLISHABLE_KEY&customerEmail=shopper%40example.com&timestamp=1735689600&signature=9f86d081..." \
  -H "Content-Type: application/json" \
  -d '{
  "name": "string"
}'

Request

import { client } from "@meisei/api/widget/client"
import { postWidgetsWishlists } from "@meisei/api/widget"

client.setConfig({
  baseUrl: "https://your-store.meisei.app/api",
})

const { data, error } = await postWidgetsWishlists({
  query: {
    apiPublishableKey: "pk_YOUR_PUBLISHABLE_KEY",
    customerEmail: "shopper@example.com",
    timestamp: "1735689600",
    signature: "9f86d081...",
  },
  body: {
    name: "string",
  },
})

Request

require "meisei"

meisei = Meisei::WidgetClient.new(
  publishable_key: "pk_YOUR_PUBLISHABLE_KEY",
  base_url: "https://your-store.meisei.app/api",
)

result = meisei.wishlists.create(
  customer_email: "shopper@example.com",
  timestamp: "1735689600",
  signature: "9f86d081...",
  name: "string",
)

Request

from meisei import WidgetClient

meisei = WidgetClient(
    publishable_key="pk_YOUR_PUBLISHABLE_KEY",
    base_url="https://your-store.meisei.app/api",
)

result = meisei.wishlists.create(
    customer_email="shopper@example.com",
    timestamp="1735689600",
    signature="9f86d081...",
    name="string",
)

Response

{
  "wishlist": {
    "id": "A4Ws1igz",
    "name": "string",
    "itemsCount": 0,
    "shared": true,
    "shareUrl": "https://example.com",
    "shareToken": "string",
    "isDefault": true,
    "createdAt": "2025-01-15T09:30:00Z",
    "updatedAt": "2025-01-15T09:30:00Z",
    "items": [
      {
        "id": "...",
        "productId": "...",
        "productVariantId": "...",
        "quantity": "...",
        "note": "...",
        "imageUrl": "...",
        "purchasedQuantity": "...",
        "createdAt": "...",
        "product": "...",
        "variant": "..."
      }
    ]
  },
  "sharingEnabled": true,
  "multipleWishlists": true,
  "itemImagesEnabled": true
}

Response schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "wishlist": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "Unique identifier for the wishlist.",
          "idCodec": "sqid"
        },
        "name": {
          "type": "string"
        },
        "itemsCount": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "shared": {
          "type": "boolean",
          "description": "Whether anyone with the share link can view the wishlist."
        },
        "shareUrl": {
          "type": "string",
          "format": "uri",
          "description": "The public link to the wishlist. It only works while the wishlist is shared."
        },
        "shareToken": {
          "type": "string",
          "description": "The token in the share link, for building a product link that opens with the shopper's photo and note: `?meiseiWishlist=<shareToken>&meiseiItem=<itemId>`. Only meaningful while the wishlist is shared."
        },
        "isDefault": {
          "type": "boolean",
          "description": "Whether this is the customer's default wishlist, the one one-click saves go to."
        },
        "createdAt": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
        },
        "updatedAt": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
        },
        "items": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "Unique identifier for the wishlist item.",
                "idCodec": "sqid"
              },
              "productId": {
                "type": "string",
                "description": "The product saved to the wishlist.",
                "idCodec": "sqid"
              },
              "productVariantId": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "The variant saved, or null for the product as a whole.",
                    "idCodec": "sqid"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "The variant saved, or null for the product as a whole."
              },
              "quantity": {
                "anyOf": [
                  {
                    "type": "integer",
                    "minimum": -9007199254740991,
                    "maximum": 9007199254740991
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "How many of this item the customer wants, or null if they did not say."
              },
              "note": {
                "type": "string",
                "description": "The customer's note about this item, such as a size or color preference."
              },
              "imageUrl": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "The customer's own photo of the item, to show in place of the product image, or null if they added none or the store has photos switched off."
              },
              "purchasedQuantity": {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991,
                "description": "How many of this item the customer has bought themselves."
              },
              "createdAt": {
                "type": "string",
                "format": "date-time",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
              },
              "product": {
                "type": "object",
                "properties": {
                  "slug": {
                    "type": "string"
                  },
                  "title": {
                    "type": "string"
                  },
                  "imageUrl": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "url": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "URL of the product's page on the storefront, or null if it is not known."
                  },
                  "metadata": {
                    "type": "object",
                    "propertyNames": {
                      "type": "string"
                    },
                    "additionalProperties": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "number"
                        },
                        {
                          "type": "boolean"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ],
                      "description": "A metadata value: a string, a number, true or false, or a list of strings. A key with a metadata definition holds the type its definition names."
                    },
                    "description": "The record's custom fields that are shown on the storefront, keyed by field key. Only fields with `storefront` switched on in `/metadata-definitions` appear, and a field with no value is left out."
                  }
                },
                "required": ["slug", "title", "imageUrl", "url", "metadata"],
                "additionalProperties": false
              },
              "variant": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string",
                        "description": "Unique identifier for the variant.",
                        "idCodec": "sqid"
                      },
                      "slug": {
                        "type": "string"
                      },
                      "title": {
                        "type": "string"
                      },
                      "metadata": {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "array",
                              "items": {
                                "type": "string"
                              }
                            }
                          ],
                          "description": "A metadata value: a string, a number, true or false, or a list of strings. A key with a metadata definition holds the type its definition names."
                        },
                        "description": "The record's custom fields that are shown on the storefront, keyed by field key. Only fields with `storefront` switched on in `/metadata-definitions` appear, and a field with no value is left out."
                      }
                    },
                    "required": ["id", "slug", "title", "metadata"],
                    "additionalProperties": false
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "required": [
              "id",
              "productId",
              "productVariantId",
              "quantity",
              "note",
              "imageUrl",
              "purchasedQuantity",
              "createdAt",
              "product",
              "variant"
            ],
            "additionalProperties": false
          }
        }
      },
      "required": [
        "id",
        "name",
        "itemsCount",
        "shared",
        "shareUrl",
        "shareToken",
        "isDefault",
        "createdAt",
        "updatedAt",
        "items"
      ],
      "additionalProperties": false
    },
    "sharingEnabled": {
      "type": "boolean",
      "description": "Whether this store allows wishlist sharing at all. When false, hide every share control."
    },
    "multipleWishlists": {
      "type": "boolean",
      "description": "Whether this store lets a customer keep several wishlists. When false, everything they save goes on one list, so hide the controls for creating or naming another. Lists a customer already holds keep working either way."
    },
    "itemImagesEnabled": {
      "type": "boolean",
      "description": "Whether this store lets a signed-in customer attach their own photo to a saved item. When false, hide the photo picker; any photo already on an item comes back as null."
    }
  },
  "required": ["wishlist", "sharingEnabled", "multipleWishlists", "itemImagesEnabled"],
  "additionalProperties": false
}

GET `/widgets/wishlists/{id}`

Get a wishlist with its items

Path parameters

idstringrequired

The ID of the wishlist.

Query parameters

apiPublishableKeystring

Your organization's publishable key, from Settings, API keys. Leave it out when the request carries a secret key as a bearer token instead, which is how a server calls these endpoints.

customerEmailstring (email)required

Email address of the customer the storefront signed in.

timestampstringrequired

Unix time in seconds when the signature was generated. It is accepted for 24 hours.

signaturestringrequired

Hex HMAC-SHA256 of customerEmail followed by timestamp, keyed with your widget signing secret. See the widgets guide for the recipe.

Request

curl \
  "https://your-store.meisei.app/api/widgets/wishlists/A4Ws1igz?apiPublishableKey=pk_YOUR_PUBLISHABLE_KEY&customerEmail=shopper%40example.com&timestamp=1735689600&signature=9f86d081..."

Request

import { client } from "@meisei/api/widget/client"
import { getWidgetsWishlistsById } from "@meisei/api/widget"

client.setConfig({
  baseUrl: "https://your-store.meisei.app/api",
})

const { data, error } = await getWidgetsWishlistsById({
  path: { id: "A4Ws1igz" },
  query: {
    apiPublishableKey: "pk_YOUR_PUBLISHABLE_KEY",
    customerEmail: "shopper@example.com",
    timestamp: "1735689600",
    signature: "9f86d081...",
  },
})

Request

require "meisei"

meisei = Meisei::WidgetClient.new(
  publishable_key: "pk_YOUR_PUBLISHABLE_KEY",
  base_url: "https://your-store.meisei.app/api",
)

result = meisei.wishlists.retrieve(
  "A4Ws1igz",
  customer_email: "shopper@example.com",
  timestamp: "1735689600",
  signature: "9f86d081...",
)

Request

from meisei import WidgetClient

meisei = WidgetClient(
    publishable_key="pk_YOUR_PUBLISHABLE_KEY",
    base_url="https://your-store.meisei.app/api",
)

result = meisei.wishlists.retrieve(
    "A4Ws1igz",
    customer_email="shopper@example.com",
    timestamp="1735689600",
    signature="9f86d081...",
)

Response

{
  "wishlist": {
    "id": "A4Ws1igz",
    "name": "string",
    "itemsCount": 0,
    "shared": true,
    "shareUrl": "https://example.com",
    "shareToken": "string",
    "isDefault": true,
    "createdAt": "2025-01-15T09:30:00Z",
    "updatedAt": "2025-01-15T09:30:00Z",
    "items": [
      {
        "id": "...",
        "productId": "...",
        "productVariantId": "...",
        "quantity": "...",
        "note": "...",
        "imageUrl": "...",
        "purchasedQuantity": "...",
        "createdAt": "...",
        "product": "...",
        "variant": "..."
      }
    ]
  },
  "sharingEnabled": true,
  "multipleWishlists": true,
  "itemImagesEnabled": true
}

Response schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "wishlist": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "Unique identifier for the wishlist.",
          "idCodec": "sqid"
        },
        "name": {
          "type": "string"
        },
        "itemsCount": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "shared": {
          "type": "boolean",
          "description": "Whether anyone with the share link can view the wishlist."
        },
        "shareUrl": {
          "type": "string",
          "format": "uri",
          "description": "The public link to the wishlist. It only works while the wishlist is shared."
        },
        "shareToken": {
          "type": "string",
          "description": "The token in the share link, for building a product link that opens with the shopper's photo and note: `?meiseiWishlist=<shareToken>&meiseiItem=<itemId>`. Only meaningful while the wishlist is shared."
        },
        "isDefault": {
          "type": "boolean",
          "description": "Whether this is the customer's default wishlist, the one one-click saves go to."
        },
        "createdAt": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
        },
        "updatedAt": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
        },
        "items": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "Unique identifier for the wishlist item.",
                "idCodec": "sqid"
              },
              "productId": {
                "type": "string",
                "description": "The product saved to the wishlist.",
                "idCodec": "sqid"
              },
              "productVariantId": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "The variant saved, or null for the product as a whole.",
                    "idCodec": "sqid"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "The variant saved, or null for the product as a whole."
              },
              "quantity": {
                "anyOf": [
                  {
                    "type": "integer",
                    "minimum": -9007199254740991,
                    "maximum": 9007199254740991
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "How many of this item the customer wants, or null if they did not say."
              },
              "note": {
                "type": "string",
                "description": "The customer's note about this item, such as a size or color preference."
              },
              "imageUrl": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "The customer's own photo of the item, to show in place of the product image, or null if they added none or the store has photos switched off."
              },
              "purchasedQuantity": {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991,
                "description": "How many of this item the customer has bought themselves."
              },
              "createdAt": {
                "type": "string",
                "format": "date-time",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
              },
              "product": {
                "type": "object",
                "properties": {
                  "slug": {
                    "type": "string"
                  },
                  "title": {
                    "type": "string"
                  },
                  "imageUrl": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "url": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "URL of the product's page on the storefront, or null if it is not known."
                  },
                  "metadata": {
                    "type": "object",
                    "propertyNames": {
                      "type": "string"
                    },
                    "additionalProperties": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "number"
                        },
                        {
                          "type": "boolean"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ],
                      "description": "A metadata value: a string, a number, true or false, or a list of strings. A key with a metadata definition holds the type its definition names."
                    },
                    "description": "The record's custom fields that are shown on the storefront, keyed by field key. Only fields with `storefront` switched on in `/metadata-definitions` appear, and a field with no value is left out."
                  }
                },
                "required": ["slug", "title", "imageUrl", "url", "metadata"],
                "additionalProperties": false
              },
              "variant": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string",
                        "description": "Unique identifier for the variant.",
                        "idCodec": "sqid"
                      },
                      "slug": {
                        "type": "string"
                      },
                      "title": {
                        "type": "string"
                      },
                      "metadata": {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "array",
                              "items": {
                                "type": "string"
                              }
                            }
                          ],
                          "description": "A metadata value: a string, a number, true or false, or a list of strings. A key with a metadata definition holds the type its definition names."
                        },
                        "description": "The record's custom fields that are shown on the storefront, keyed by field key. Only fields with `storefront` switched on in `/metadata-definitions` appear, and a field with no value is left out."
                      }
                    },
                    "required": ["id", "slug", "title", "metadata"],
                    "additionalProperties": false
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "required": [
              "id",
              "productId",
              "productVariantId",
              "quantity",
              "note",
              "imageUrl",
              "purchasedQuantity",
              "createdAt",
              "product",
              "variant"
            ],
            "additionalProperties": false
          }
        }
      },
      "required": [
        "id",
        "name",
        "itemsCount",
        "shared",
        "shareUrl",
        "shareToken",
        "isDefault",
        "createdAt",
        "updatedAt",
        "items"
      ],
      "additionalProperties": false
    },
    "sharingEnabled": {
      "type": "boolean",
      "description": "Whether this store allows wishlist sharing at all. When false, hide every share control."
    },
    "multipleWishlists": {
      "type": "boolean",
      "description": "Whether this store lets a customer keep several wishlists. When false, everything they save goes on one list, so hide the controls for creating or naming another. Lists a customer already holds keep working either way."
    },
    "itemImagesEnabled": {
      "type": "boolean",
      "description": "Whether this store lets a signed-in customer attach their own photo to a saved item. When false, hide the photo picker; any photo already on an item comes back as null."
    }
  },
  "required": ["wishlist", "sharingEnabled", "multipleWishlists", "itemImagesEnabled"],
  "additionalProperties": false
}

PATCH `/widgets/wishlists/{id}`

Update a wishlist's settings: its name or whether it is shared

Path parameters

idstringrequired

The ID of the wishlist.

Query parameters

apiPublishableKeystring

Your organization's publishable key, from Settings, API keys. Leave it out when the request carries a secret key as a bearer token instead, which is how a server calls these endpoints.

customerEmailstring (email)required

Email address of the customer the storefront signed in.

timestampstringrequired

Unix time in seconds when the signature was generated. It is accepted for 24 hours.

signaturestringrequired

Hex HMAC-SHA256 of customerEmail followed by timestamp, keyed with your widget signing secret. See the widgets guide for the recipe.

Body parameters

namestring

A new name for the wishlist.

sharedboolean

Turns the wishlist's share link on or off.

isDefaultboolean

Makes this wishlist the customer's default for one-click saves. Send false to leave the customer without a default.

Request

curl \
  -X PATCH \
  "https://your-store.meisei.app/api/widgets/wishlists/A4Ws1igz?apiPublishableKey=pk_YOUR_PUBLISHABLE_KEY&customerEmail=shopper%40example.com&timestamp=1735689600&signature=9f86d081..." \
  -H "Content-Type: application/json" \
  -d '{
  "name": "string",
  "shared": true,
  "isDefault": true
}'

Request

import { client } from "@meisei/api/widget/client"
import { patchWidgetsWishlistsById } from "@meisei/api/widget"

client.setConfig({
  baseUrl: "https://your-store.meisei.app/api",
})

const { data, error } = await patchWidgetsWishlistsById({
  path: { id: "A4Ws1igz" },
  query: {
    apiPublishableKey: "pk_YOUR_PUBLISHABLE_KEY",
    customerEmail: "shopper@example.com",
    timestamp: "1735689600",
    signature: "9f86d081...",
  },
  body: {
    name: "string",
    shared: true,
    isDefault: true,
  },
})

Request

require "meisei"

meisei = Meisei::WidgetClient.new(
  publishable_key: "pk_YOUR_PUBLISHABLE_KEY",
  base_url: "https://your-store.meisei.app/api",
)

result = meisei.wishlists.update(
  "A4Ws1igz",
  customer_email: "shopper@example.com",
  timestamp: "1735689600",
  signature: "9f86d081...",
  name: "string",
  shared: true,
  is_default: true,
)

Request

from meisei import WidgetClient

meisei = WidgetClient(
    publishable_key="pk_YOUR_PUBLISHABLE_KEY",
    base_url="https://your-store.meisei.app/api",
)

result = meisei.wishlists.update(
    "A4Ws1igz",
    customer_email="shopper@example.com",
    timestamp="1735689600",
    signature="9f86d081...",
    name="string",
    shared=True,
    is_default=True,
)

Response

{
  "wishlist": {
    "id": "A4Ws1igz",
    "name": "string",
    "itemsCount": 0,
    "shared": true,
    "shareUrl": "https://example.com",
    "shareToken": "string",
    "isDefault": true,
    "createdAt": "2025-01-15T09:30:00Z",
    "updatedAt": "2025-01-15T09:30:00Z",
    "items": [
      {
        "id": "...",
        "productId": "...",
        "productVariantId": "...",
        "quantity": "...",
        "note": "...",
        "imageUrl": "...",
        "purchasedQuantity": "...",
        "createdAt": "...",
        "product": "...",
        "variant": "..."
      }
    ]
  },
  "sharingEnabled": true,
  "multipleWishlists": true,
  "itemImagesEnabled": true
}

Response schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "wishlist": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "Unique identifier for the wishlist.",
          "idCodec": "sqid"
        },
        "name": {
          "type": "string"
        },
        "itemsCount": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "shared": {
          "type": "boolean",
          "description": "Whether anyone with the share link can view the wishlist."
        },
        "shareUrl": {
          "type": "string",
          "format": "uri",
          "description": "The public link to the wishlist. It only works while the wishlist is shared."
        },
        "shareToken": {
          "type": "string",
          "description": "The token in the share link, for building a product link that opens with the shopper's photo and note: `?meiseiWishlist=<shareToken>&meiseiItem=<itemId>`. Only meaningful while the wishlist is shared."
        },
        "isDefault": {
          "type": "boolean",
          "description": "Whether this is the customer's default wishlist, the one one-click saves go to."
        },
        "createdAt": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
        },
        "updatedAt": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
        },
        "items": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "Unique identifier for the wishlist item.",
                "idCodec": "sqid"
              },
              "productId": {
                "type": "string",
                "description": "The product saved to the wishlist.",
                "idCodec": "sqid"
              },
              "productVariantId": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "The variant saved, or null for the product as a whole.",
                    "idCodec": "sqid"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "The variant saved, or null for the product as a whole."
              },
              "quantity": {
                "anyOf": [
                  {
                    "type": "integer",
                    "minimum": -9007199254740991,
                    "maximum": 9007199254740991
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "How many of this item the customer wants, or null if they did not say."
              },
              "note": {
                "type": "string",
                "description": "The customer's note about this item, such as a size or color preference."
              },
              "imageUrl": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "The customer's own photo of the item, to show in place of the product image, or null if they added none or the store has photos switched off."
              },
              "purchasedQuantity": {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991,
                "description": "How many of this item the customer has bought themselves."
              },
              "createdAt": {
                "type": "string",
                "format": "date-time",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
              },
              "product": {
                "type": "object",
                "properties": {
                  "slug": {
                    "type": "string"
                  },
                  "title": {
                    "type": "string"
                  },
                  "imageUrl": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "url": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "URL of the product's page on the storefront, or null if it is not known."
                  },
                  "metadata": {
                    "type": "object",
                    "propertyNames": {
                      "type": "string"
                    },
                    "additionalProperties": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "number"
                        },
                        {
                          "type": "boolean"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ],
                      "description": "A metadata value: a string, a number, true or false, or a list of strings. A key with a metadata definition holds the type its definition names."
                    },
                    "description": "The record's custom fields that are shown on the storefront, keyed by field key. Only fields with `storefront` switched on in `/metadata-definitions` appear, and a field with no value is left out."
                  }
                },
                "required": ["slug", "title", "imageUrl", "url", "metadata"],
                "additionalProperties": false
              },
              "variant": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string",
                        "description": "Unique identifier for the variant.",
                        "idCodec": "sqid"
                      },
                      "slug": {
                        "type": "string"
                      },
                      "title": {
                        "type": "string"
                      },
                      "metadata": {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "array",
                              "items": {
                                "type": "string"
                              }
                            }
                          ],
                          "description": "A metadata value: a string, a number, true or false, or a list of strings. A key with a metadata definition holds the type its definition names."
                        },
                        "description": "The record's custom fields that are shown on the storefront, keyed by field key. Only fields with `storefront` switched on in `/metadata-definitions` appear, and a field with no value is left out."
                      }
                    },
                    "required": ["id", "slug", "title", "metadata"],
                    "additionalProperties": false
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "required": [
              "id",
              "productId",
              "productVariantId",
              "quantity",
              "note",
              "imageUrl",
              "purchasedQuantity",
              "createdAt",
              "product",
              "variant"
            ],
            "additionalProperties": false
          }
        }
      },
      "required": [
        "id",
        "name",
        "itemsCount",
        "shared",
        "shareUrl",
        "shareToken",
        "isDefault",
        "createdAt",
        "updatedAt",
        "items"
      ],
      "additionalProperties": false
    },
    "sharingEnabled": {
      "type": "boolean",
      "description": "Whether this store allows wishlist sharing at all. When false, hide every share control."
    },
    "multipleWishlists": {
      "type": "boolean",
      "description": "Whether this store lets a customer keep several wishlists. When false, everything they save goes on one list, so hide the controls for creating or naming another. Lists a customer already holds keep working either way."
    },
    "itemImagesEnabled": {
      "type": "boolean",
      "description": "Whether this store lets a signed-in customer attach their own photo to a saved item. When false, hide the photo picker; any photo already on an item comes back as null."
    }
  },
  "required": ["wishlist", "sharingEnabled", "multipleWishlists", "itemImagesEnabled"],
  "additionalProperties": false
}

DELETE `/widgets/wishlists/{id}`

Delete a wishlist

Path parameters

idstringrequired

The ID of the wishlist.

Query parameters

apiPublishableKeystring

Your organization's publishable key, from Settings, API keys. Leave it out when the request carries a secret key as a bearer token instead, which is how a server calls these endpoints.

customerEmailstring (email)required

Email address of the customer the storefront signed in.

timestampstringrequired

Unix time in seconds when the signature was generated. It is accepted for 24 hours.

signaturestringrequired

Hex HMAC-SHA256 of customerEmail followed by timestamp, keyed with your widget signing secret. See the widgets guide for the recipe.

Request

curl \
  -X DELETE \
  "https://your-store.meisei.app/api/widgets/wishlists/A4Ws1igz?apiPublishableKey=pk_YOUR_PUBLISHABLE_KEY&customerEmail=shopper%40example.com&timestamp=1735689600&signature=9f86d081..."

Request

import { client } from "@meisei/api/widget/client"
import { deleteWidgetsWishlistsById } from "@meisei/api/widget"

client.setConfig({
  baseUrl: "https://your-store.meisei.app/api",
})

const { data, error } = await deleteWidgetsWishlistsById({
  path: { id: "A4Ws1igz" },
  query: {
    apiPublishableKey: "pk_YOUR_PUBLISHABLE_KEY",
    customerEmail: "shopper@example.com",
    timestamp: "1735689600",
    signature: "9f86d081...",
  },
})

Request

require "meisei"

meisei = Meisei::WidgetClient.new(
  publishable_key: "pk_YOUR_PUBLISHABLE_KEY",
  base_url: "https://your-store.meisei.app/api",
)

result = meisei.wishlists.delete(
  "A4Ws1igz",
  customer_email: "shopper@example.com",
  timestamp: "1735689600",
  signature: "9f86d081...",
)

Request

from meisei import WidgetClient

meisei = WidgetClient(
    publishable_key="pk_YOUR_PUBLISHABLE_KEY",
    base_url="https://your-store.meisei.app/api",
)

result = meisei.wishlists.delete(
    "A4Ws1igz",
    customer_email="shopper@example.com",
    timestamp="1735689600",
    signature="9f86d081...",
)

Response

{
  "id": "A4Ws1igz"
}

Response schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The ID of the wishlist that was deleted.",
      "idCodec": "sqid"
    }
  },
  "required": ["id"],
  "additionalProperties": false
}

POST `/widgets/wishlists/{id}/share-token`

Generate a new share token for a wishlist, invalidating the old share link

Path parameters

idstringrequired

The ID of the wishlist.

Query parameters

apiPublishableKeystring

Your organization's publishable key, from Settings, API keys. Leave it out when the request carries a secret key as a bearer token instead, which is how a server calls these endpoints.

customerEmailstring (email)required

Email address of the customer the storefront signed in.

timestampstringrequired

Unix time in seconds when the signature was generated. It is accepted for 24 hours.

signaturestringrequired

Hex HMAC-SHA256 of customerEmail followed by timestamp, keyed with your widget signing secret. See the widgets guide for the recipe.

Request

curl \
  -X POST \
  "https://your-store.meisei.app/api/widgets/wishlists/A4Ws1igz/share-token?apiPublishableKey=pk_YOUR_PUBLISHABLE_KEY&customerEmail=shopper%40example.com&timestamp=1735689600&signature=9f86d081..."

Request

import { client } from "@meisei/api/widget/client"
import { postWidgetsWishlistsByIdShareToken } from "@meisei/api/widget"

client.setConfig({
  baseUrl: "https://your-store.meisei.app/api",
})

const { data, error } = await postWidgetsWishlistsByIdShareToken({
  path: { id: "A4Ws1igz" },
  query: {
    apiPublishableKey: "pk_YOUR_PUBLISHABLE_KEY",
    customerEmail: "shopper@example.com",
    timestamp: "1735689600",
    signature: "9f86d081...",
  },
})

Request

require "meisei"

meisei = Meisei::WidgetClient.new(
  publishable_key: "pk_YOUR_PUBLISHABLE_KEY",
  base_url: "https://your-store.meisei.app/api",
)

result = meisei.wishlists.create_share_token(
  "A4Ws1igz",
  customer_email: "shopper@example.com",
  timestamp: "1735689600",
  signature: "9f86d081...",
)

Request

from meisei import WidgetClient

meisei = WidgetClient(
    publishable_key="pk_YOUR_PUBLISHABLE_KEY",
    base_url="https://your-store.meisei.app/api",
)

result = meisei.wishlists.create_share_token(
    "A4Ws1igz",
    customer_email="shopper@example.com",
    timestamp="1735689600",
    signature="9f86d081...",
)

Response

{
  "wishlist": {
    "id": "A4Ws1igz",
    "name": "string",
    "itemsCount": 0,
    "shared": true,
    "shareUrl": "https://example.com",
    "shareToken": "string",
    "isDefault": true,
    "createdAt": "2025-01-15T09:30:00Z",
    "updatedAt": "2025-01-15T09:30:00Z",
    "items": [
      {
        "id": "...",
        "productId": "...",
        "productVariantId": "...",
        "quantity": "...",
        "note": "...",
        "imageUrl": "...",
        "purchasedQuantity": "...",
        "createdAt": "...",
        "product": "...",
        "variant": "..."
      }
    ]
  },
  "sharingEnabled": true,
  "multipleWishlists": true,
  "itemImagesEnabled": true
}

Response schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "wishlist": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "Unique identifier for the wishlist.",
          "idCodec": "sqid"
        },
        "name": {
          "type": "string"
        },
        "itemsCount": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "shared": {
          "type": "boolean",
          "description": "Whether anyone with the share link can view the wishlist."
        },
        "shareUrl": {
          "type": "string",
          "format": "uri",
          "description": "The public link to the wishlist. It only works while the wishlist is shared."
        },
        "shareToken": {
          "type": "string",
          "description": "The token in the share link, for building a product link that opens with the shopper's photo and note: `?meiseiWishlist=<shareToken>&meiseiItem=<itemId>`. Only meaningful while the wishlist is shared."
        },
        "isDefault": {
          "type": "boolean",
          "description": "Whether this is the customer's default wishlist, the one one-click saves go to."
        },
        "createdAt": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
        },
        "updatedAt": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
        },
        "items": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "Unique identifier for the wishlist item.",
                "idCodec": "sqid"
              },
              "productId": {
                "type": "string",
                "description": "The product saved to the wishlist.",
                "idCodec": "sqid"
              },
              "productVariantId": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "The variant saved, or null for the product as a whole.",
                    "idCodec": "sqid"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "The variant saved, or null for the product as a whole."
              },
              "quantity": {
                "anyOf": [
                  {
                    "type": "integer",
                    "minimum": -9007199254740991,
                    "maximum": 9007199254740991
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "How many of this item the customer wants, or null if they did not say."
              },
              "note": {
                "type": "string",
                "description": "The customer's note about this item, such as a size or color preference."
              },
              "imageUrl": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "The customer's own photo of the item, to show in place of the product image, or null if they added none or the store has photos switched off."
              },
              "purchasedQuantity": {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991,
                "description": "How many of this item the customer has bought themselves."
              },
              "createdAt": {
                "type": "string",
                "format": "date-time",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
              },
              "product": {
                "type": "object",
                "properties": {
                  "slug": {
                    "type": "string"
                  },
                  "title": {
                    "type": "string"
                  },
                  "imageUrl": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "url": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "URL of the product's page on the storefront, or null if it is not known."
                  },
                  "metadata": {
                    "type": "object",
                    "propertyNames": {
                      "type": "string"
                    },
                    "additionalProperties": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "number"
                        },
                        {
                          "type": "boolean"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ],
                      "description": "A metadata value: a string, a number, true or false, or a list of strings. A key with a metadata definition holds the type its definition names."
                    },
                    "description": "The record's custom fields that are shown on the storefront, keyed by field key. Only fields with `storefront` switched on in `/metadata-definitions` appear, and a field with no value is left out."
                  }
                },
                "required": ["slug", "title", "imageUrl", "url", "metadata"],
                "additionalProperties": false
              },
              "variant": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string",
                        "description": "Unique identifier for the variant.",
                        "idCodec": "sqid"
                      },
                      "slug": {
                        "type": "string"
                      },
                      "title": {
                        "type": "string"
                      },
                      "metadata": {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "array",
                              "items": {
                                "type": "string"
                              }
                            }
                          ],
                          "description": "A metadata value: a string, a number, true or false, or a list of strings. A key with a metadata definition holds the type its definition names."
                        },
                        "description": "The record's custom fields that are shown on the storefront, keyed by field key. Only fields with `storefront` switched on in `/metadata-definitions` appear, and a field with no value is left out."
                      }
                    },
                    "required": ["id", "slug", "title", "metadata"],
                    "additionalProperties": false
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "required": [
              "id",
              "productId",
              "productVariantId",
              "quantity",
              "note",
              "imageUrl",
              "purchasedQuantity",
              "createdAt",
              "product",
              "variant"
            ],
            "additionalProperties": false
          }
        }
      },
      "required": [
        "id",
        "name",
        "itemsCount",
        "shared",
        "shareUrl",
        "shareToken",
        "isDefault",
        "createdAt",
        "updatedAt",
        "items"
      ],
      "additionalProperties": false
    },
    "sharingEnabled": {
      "type": "boolean",
      "description": "Whether this store allows wishlist sharing at all. When false, hide every share control."
    },
    "multipleWishlists": {
      "type": "boolean",
      "description": "Whether this store lets a customer keep several wishlists. When false, everything they save goes on one list, so hide the controls for creating or naming another. Lists a customer already holds keep working either way."
    },
    "itemImagesEnabled": {
      "type": "boolean",
      "description": "Whether this store lets a signed-in customer attach their own photo to a saved item. When false, hide the photo picker; any photo already on an item comes back as null."
    }
  },
  "required": ["wishlist", "sharingEnabled", "multipleWishlists", "itemImagesEnabled"],
  "additionalProperties": false
}

POST `/widgets/wishlists/{id}/items`

Add an item to a wishlist

Path parameters

idstringrequired

The ID of the wishlist.

Query parameters

apiPublishableKeystring

Your organization's publishable key, from Settings, API keys. Leave it out when the request carries a secret key as a bearer token instead, which is how a server calls these endpoints.

customerEmailstring (email)required

Email address of the customer the storefront signed in.

timestampstringrequired

Unix time in seconds when the signature was generated. It is accepted for 24 hours.

signaturestringrequired

Hex HMAC-SHA256 of customerEmail followed by timestamp, keyed with your widget signing secret. See the widgets guide for the recipe.

Body parameters

productSlugstring

Slug of the product. Send this or productExternalId.

productExternalIdstring

The product's ID on one of your sites, such as its Shopify product ID, sent instead of productSlug. Either Shopify form works.

sitestring

The slug of the site productExternalId belongs to. Only needed when the same ID is on more than one of your sites.

productVariantIdstring | null

The variant the customer chose, or null to save the product as a whole.

quantityinteger | null

How many of this item the customer wants. Leave it out if they did not say.

notestring

A short note about this item, such as a size or color preference.

Request

curl \
  -X POST \
  "https://your-store.meisei.app/api/widgets/wishlists/A4Ws1igz/items?apiPublishableKey=pk_YOUR_PUBLISHABLE_KEY&customerEmail=shopper%40example.com&timestamp=1735689600&signature=9f86d081..." \
  -H "Content-Type: application/json" \
  -d '{
  "productSlug": "string",
  "productExternalId": "string",
  "site": "string",
  "productVariantId": "string",
  "quantity": 0,
  "note": "string"
}'

Request

import { client } from "@meisei/api/widget/client"
import { postWidgetsWishlistsByIdItems } from "@meisei/api/widget"

client.setConfig({
  baseUrl: "https://your-store.meisei.app/api",
})

const { data, error } = await postWidgetsWishlistsByIdItems({
  path: { id: "A4Ws1igz" },
  query: {
    apiPublishableKey: "pk_YOUR_PUBLISHABLE_KEY",
    customerEmail: "shopper@example.com",
    timestamp: "1735689600",
    signature: "9f86d081...",
  },
  body: {
    productSlug: "string",
    productExternalId: "string",
    site: "string",
    productVariantId: "string",
    quantity: 0,
    note: "string",
  },
})

Request

require "meisei"

meisei = Meisei::WidgetClient.new(
  publishable_key: "pk_YOUR_PUBLISHABLE_KEY",
  base_url: "https://your-store.meisei.app/api",
)

result = meisei.wishlists.items.create(
  "A4Ws1igz",
  customer_email: "shopper@example.com",
  timestamp: "1735689600",
  signature: "9f86d081...",
  product_slug: "string",
  product_external_id: "string",
  site: "string",
  product_variant_id: "string",
  quantity: 0,
  note: "string",
)

Request

from meisei import WidgetClient

meisei = WidgetClient(
    publishable_key="pk_YOUR_PUBLISHABLE_KEY",
    base_url="https://your-store.meisei.app/api",
)

result = meisei.wishlists.items.create(
    "A4Ws1igz",
    customer_email="shopper@example.com",
    timestamp="1735689600",
    signature="9f86d081...",
    product_slug="string",
    product_external_id="string",
    site="string",
    product_variant_id="string",
    quantity=0,
    note="string",
)

Response

{
  "wishlist": {
    "id": "A4Ws1igz",
    "name": "string",
    "itemsCount": 0,
    "shared": true,
    "shareUrl": "https://example.com",
    "shareToken": "string",
    "isDefault": true,
    "createdAt": "2025-01-15T09:30:00Z",
    "updatedAt": "2025-01-15T09:30:00Z",
    "items": [
      {
        "id": "...",
        "productId": "...",
        "productVariantId": "...",
        "quantity": "...",
        "note": "...",
        "imageUrl": "...",
        "purchasedQuantity": "...",
        "createdAt": "...",
        "product": "...",
        "variant": "..."
      }
    ]
  },
  "sharingEnabled": true,
  "multipleWishlists": true,
  "itemImagesEnabled": true
}

Response schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "wishlist": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "Unique identifier for the wishlist.",
          "idCodec": "sqid"
        },
        "name": {
          "type": "string"
        },
        "itemsCount": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "shared": {
          "type": "boolean",
          "description": "Whether anyone with the share link can view the wishlist."
        },
        "shareUrl": {
          "type": "string",
          "format": "uri",
          "description": "The public link to the wishlist. It only works while the wishlist is shared."
        },
        "shareToken": {
          "type": "string",
          "description": "The token in the share link, for building a product link that opens with the shopper's photo and note: `?meiseiWishlist=<shareToken>&meiseiItem=<itemId>`. Only meaningful while the wishlist is shared."
        },
        "isDefault": {
          "type": "boolean",
          "description": "Whether this is the customer's default wishlist, the one one-click saves go to."
        },
        "createdAt": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
        },
        "updatedAt": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
        },
        "items": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "Unique identifier for the wishlist item.",
                "idCodec": "sqid"
              },
              "productId": {
                "type": "string",
                "description": "The product saved to the wishlist.",
                "idCodec": "sqid"
              },
              "productVariantId": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "The variant saved, or null for the product as a whole.",
                    "idCodec": "sqid"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "The variant saved, or null for the product as a whole."
              },
              "quantity": {
                "anyOf": [
                  {
                    "type": "integer",
                    "minimum": -9007199254740991,
                    "maximum": 9007199254740991
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "How many of this item the customer wants, or null if they did not say."
              },
              "note": {
                "type": "string",
                "description": "The customer's note about this item, such as a size or color preference."
              },
              "imageUrl": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "The customer's own photo of the item, to show in place of the product image, or null if they added none or the store has photos switched off."
              },
              "purchasedQuantity": {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991,
                "description": "How many of this item the customer has bought themselves."
              },
              "createdAt": {
                "type": "string",
                "format": "date-time",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
              },
              "product": {
                "type": "object",
                "properties": {
                  "slug": {
                    "type": "string"
                  },
                  "title": {
                    "type": "string"
                  },
                  "imageUrl": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "url": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "URL of the product's page on the storefront, or null if it is not known."
                  },
                  "metadata": {
                    "type": "object",
                    "propertyNames": {
                      "type": "string"
                    },
                    "additionalProperties": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "number"
                        },
                        {
                          "type": "boolean"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ],
                      "description": "A metadata value: a string, a number, true or false, or a list of strings. A key with a metadata definition holds the type its definition names."
                    },
                    "description": "The record's custom fields that are shown on the storefront, keyed by field key. Only fields with `storefront` switched on in `/metadata-definitions` appear, and a field with no value is left out."
                  }
                },
                "required": ["slug", "title", "imageUrl", "url", "metadata"],
                "additionalProperties": false
              },
              "variant": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string",
                        "description": "Unique identifier for the variant.",
                        "idCodec": "sqid"
                      },
                      "slug": {
                        "type": "string"
                      },
                      "title": {
                        "type": "string"
                      },
                      "metadata": {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "array",
                              "items": {
                                "type": "string"
                              }
                            }
                          ],
                          "description": "A metadata value: a string, a number, true or false, or a list of strings. A key with a metadata definition holds the type its definition names."
                        },
                        "description": "The record's custom fields that are shown on the storefront, keyed by field key. Only fields with `storefront` switched on in `/metadata-definitions` appear, and a field with no value is left out."
                      }
                    },
                    "required": ["id", "slug", "title", "metadata"],
                    "additionalProperties": false
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "required": [
              "id",
              "productId",
              "productVariantId",
              "quantity",
              "note",
              "imageUrl",
              "purchasedQuantity",
              "createdAt",
              "product",
              "variant"
            ],
            "additionalProperties": false
          }
        }
      },
      "required": [
        "id",
        "name",
        "itemsCount",
        "shared",
        "shareUrl",
        "shareToken",
        "isDefault",
        "createdAt",
        "updatedAt",
        "items"
      ],
      "additionalProperties": false
    },
    "sharingEnabled": {
      "type": "boolean",
      "description": "Whether this store allows wishlist sharing at all. When false, hide every share control."
    },
    "multipleWishlists": {
      "type": "boolean",
      "description": "Whether this store lets a customer keep several wishlists. When false, everything they save goes on one list, so hide the controls for creating or naming another. Lists a customer already holds keep working either way."
    },
    "itemImagesEnabled": {
      "type": "boolean",
      "description": "Whether this store lets a signed-in customer attach their own photo to a saved item. When false, hide the photo picker; any photo already on an item comes back as null."
    }
  },
  "required": ["wishlist", "sharingEnabled", "multipleWishlists", "itemImagesEnabled"],
  "additionalProperties": false
}

PATCH `/widgets/wishlists/{id}/items/{itemId}`

Update an item's quantity, note or photo, or move it to another of the customer's wishlists

Path parameters

idstringrequired

The ID of the wishlist the item is on.

itemIdstringrequired

The ID of the wishlist item.

Query parameters

apiPublishableKeystring

Your organization's publishable key, from Settings, API keys. Leave it out when the request carries a secret key as a bearer token instead, which is how a server calls these endpoints.

customerEmailstring (email)required

Email address of the customer the storefront signed in.

timestampstringrequired

Unix time in seconds when the signature was generated. It is accepted for 24 hours.

signaturestringrequired

Hex HMAC-SHA256 of customerEmail followed by timestamp, keyed with your widget signing secret. See the widgets guide for the recipe.

Body parameters

quantityinteger | null

How many of this item the customer wants. Send null to clear it.

notestring

A short note about this item, such as a size or color preference. Send an empty string to clear it.

imageKeystring | null

The key from POST /widgets/wishlists/upload-url, to attach the customer's own photo to the item. It replaces any photo already there. Send null to take the photo off. Refused while the store has photos on saved items switched off.

wishlistIdstring

Moves the item to this wishlist, which must belong to the same customer. Any quantity or note edits in the same request are applied first. If the target list already has the same product and variant, the two entries merge: the target entry stays, keeps its quantity, and the moved item's note is appended to its note.

Request

curl \
  -X PATCH \
  "https://your-store.meisei.app/api/widgets/wishlists/A4Ws1igz/items/A4Ws1igz?apiPublishableKey=pk_YOUR_PUBLISHABLE_KEY&customerEmail=shopper%40example.com&timestamp=1735689600&signature=9f86d081..." \
  -H "Content-Type: application/json" \
  -d '{
  "quantity": 0,
  "note": "string",
  "imageKey": "string",
  "wishlistId": "string"
}'

Request

import { client } from "@meisei/api/widget/client"
import { patchWidgetsWishlistsByIdItemsByItemId } from "@meisei/api/widget"

client.setConfig({
  baseUrl: "https://your-store.meisei.app/api",
})

const { data, error } = await patchWidgetsWishlistsByIdItemsByItemId({
  path: { id: "A4Ws1igz", itemId: "A4Ws1igz" },
  query: {
    apiPublishableKey: "pk_YOUR_PUBLISHABLE_KEY",
    customerEmail: "shopper@example.com",
    timestamp: "1735689600",
    signature: "9f86d081...",
  },
  body: {
    quantity: 0,
    note: "string",
    imageKey: "string",
    wishlistId: "string",
  },
})

Request

require "meisei"

meisei = Meisei::WidgetClient.new(
  publishable_key: "pk_YOUR_PUBLISHABLE_KEY",
  base_url: "https://your-store.meisei.app/api",
)

result = meisei.wishlists.items.update(
  "A4Ws1igz",
  "A4Ws1igz",
  customer_email: "shopper@example.com",
  timestamp: "1735689600",
  signature: "9f86d081...",
  quantity: 0,
  note: "string",
  image_key: "string",
  wishlist_id: "string",
)

Request

from meisei import WidgetClient

meisei = WidgetClient(
    publishable_key="pk_YOUR_PUBLISHABLE_KEY",
    base_url="https://your-store.meisei.app/api",
)

result = meisei.wishlists.items.update(
    "A4Ws1igz",
    "A4Ws1igz",
    customer_email="shopper@example.com",
    timestamp="1735689600",
    signature="9f86d081...",
    quantity=0,
    note="string",
    image_key="string",
    wishlist_id="string",
)

Response

{
  "wishlist": {
    "id": "A4Ws1igz",
    "name": "string",
    "itemsCount": 0,
    "shared": true,
    "shareUrl": "https://example.com",
    "shareToken": "string",
    "isDefault": true,
    "createdAt": "2025-01-15T09:30:00Z",
    "updatedAt": "2025-01-15T09:30:00Z",
    "items": [
      {
        "id": "...",
        "productId": "...",
        "productVariantId": "...",
        "quantity": "...",
        "note": "...",
        "imageUrl": "...",
        "purchasedQuantity": "...",
        "createdAt": "...",
        "product": "...",
        "variant": "..."
      }
    ]
  },
  "sharingEnabled": true,
  "multipleWishlists": true,
  "itemImagesEnabled": true
}

Response schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "wishlist": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "Unique identifier for the wishlist.",
          "idCodec": "sqid"
        },
        "name": {
          "type": "string"
        },
        "itemsCount": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "shared": {
          "type": "boolean",
          "description": "Whether anyone with the share link can view the wishlist."
        },
        "shareUrl": {
          "type": "string",
          "format": "uri",
          "description": "The public link to the wishlist. It only works while the wishlist is shared."
        },
        "shareToken": {
          "type": "string",
          "description": "The token in the share link, for building a product link that opens with the shopper's photo and note: `?meiseiWishlist=<shareToken>&meiseiItem=<itemId>`. Only meaningful while the wishlist is shared."
        },
        "isDefault": {
          "type": "boolean",
          "description": "Whether this is the customer's default wishlist, the one one-click saves go to."
        },
        "createdAt": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
        },
        "updatedAt": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
        },
        "items": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "Unique identifier for the wishlist item.",
                "idCodec": "sqid"
              },
              "productId": {
                "type": "string",
                "description": "The product saved to the wishlist.",
                "idCodec": "sqid"
              },
              "productVariantId": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "The variant saved, or null for the product as a whole.",
                    "idCodec": "sqid"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "The variant saved, or null for the product as a whole."
              },
              "quantity": {
                "anyOf": [
                  {
                    "type": "integer",
                    "minimum": -9007199254740991,
                    "maximum": 9007199254740991
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "How many of this item the customer wants, or null if they did not say."
              },
              "note": {
                "type": "string",
                "description": "The customer's note about this item, such as a size or color preference."
              },
              "imageUrl": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "The customer's own photo of the item, to show in place of the product image, or null if they added none or the store has photos switched off."
              },
              "purchasedQuantity": {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991,
                "description": "How many of this item the customer has bought themselves."
              },
              "createdAt": {
                "type": "string",
                "format": "date-time",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
              },
              "product": {
                "type": "object",
                "properties": {
                  "slug": {
                    "type": "string"
                  },
                  "title": {
                    "type": "string"
                  },
                  "imageUrl": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "url": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "URL of the product's page on the storefront, or null if it is not known."
                  },
                  "metadata": {
                    "type": "object",
                    "propertyNames": {
                      "type": "string"
                    },
                    "additionalProperties": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "number"
                        },
                        {
                          "type": "boolean"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ],
                      "description": "A metadata value: a string, a number, true or false, or a list of strings. A key with a metadata definition holds the type its definition names."
                    },
                    "description": "The record's custom fields that are shown on the storefront, keyed by field key. Only fields with `storefront` switched on in `/metadata-definitions` appear, and a field with no value is left out."
                  }
                },
                "required": ["slug", "title", "imageUrl", "url", "metadata"],
                "additionalProperties": false
              },
              "variant": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string",
                        "description": "Unique identifier for the variant.",
                        "idCodec": "sqid"
                      },
                      "slug": {
                        "type": "string"
                      },
                      "title": {
                        "type": "string"
                      },
                      "metadata": {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "array",
                              "items": {
                                "type": "string"
                              }
                            }
                          ],
                          "description": "A metadata value: a string, a number, true or false, or a list of strings. A key with a metadata definition holds the type its definition names."
                        },
                        "description": "The record's custom fields that are shown on the storefront, keyed by field key. Only fields with `storefront` switched on in `/metadata-definitions` appear, and a field with no value is left out."
                      }
                    },
                    "required": ["id", "slug", "title", "metadata"],
                    "additionalProperties": false
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "required": [
              "id",
              "productId",
              "productVariantId",
              "quantity",
              "note",
              "imageUrl",
              "purchasedQuantity",
              "createdAt",
              "product",
              "variant"
            ],
            "additionalProperties": false
          }
        }
      },
      "required": [
        "id",
        "name",
        "itemsCount",
        "shared",
        "shareUrl",
        "shareToken",
        "isDefault",
        "createdAt",
        "updatedAt",
        "items"
      ],
      "additionalProperties": false
    },
    "sharingEnabled": {
      "type": "boolean",
      "description": "Whether this store allows wishlist sharing at all. When false, hide every share control."
    },
    "multipleWishlists": {
      "type": "boolean",
      "description": "Whether this store lets a customer keep several wishlists. When false, everything they save goes on one list, so hide the controls for creating or naming another. Lists a customer already holds keep working either way."
    },
    "itemImagesEnabled": {
      "type": "boolean",
      "description": "Whether this store lets a signed-in customer attach their own photo to a saved item. When false, hide the photo picker; any photo already on an item comes back as null."
    }
  },
  "required": ["wishlist", "sharingEnabled", "multipleWishlists", "itemImagesEnabled"],
  "additionalProperties": false
}

DELETE `/widgets/wishlists/{id}/items/{itemId}`

Remove an item from a wishlist

Path parameters

idstringrequired

The ID of the wishlist the item is on.

itemIdstringrequired

The ID of the wishlist item.

Query parameters

apiPublishableKeystring

Your organization's publishable key, from Settings, API keys. Leave it out when the request carries a secret key as a bearer token instead, which is how a server calls these endpoints.

customerEmailstring (email)required

Email address of the customer the storefront signed in.

timestampstringrequired

Unix time in seconds when the signature was generated. It is accepted for 24 hours.

signaturestringrequired

Hex HMAC-SHA256 of customerEmail followed by timestamp, keyed with your widget signing secret. See the widgets guide for the recipe.

Request

curl \
  -X DELETE \
  "https://your-store.meisei.app/api/widgets/wishlists/A4Ws1igz/items/A4Ws1igz?apiPublishableKey=pk_YOUR_PUBLISHABLE_KEY&customerEmail=shopper%40example.com&timestamp=1735689600&signature=9f86d081..."

Request

import { client } from "@meisei/api/widget/client"
import { deleteWidgetsWishlistsByIdItemsByItemId } from "@meisei/api/widget"

client.setConfig({
  baseUrl: "https://your-store.meisei.app/api",
})

const { data, error } = await deleteWidgetsWishlistsByIdItemsByItemId({
  path: { id: "A4Ws1igz", itemId: "A4Ws1igz" },
  query: {
    apiPublishableKey: "pk_YOUR_PUBLISHABLE_KEY",
    customerEmail: "shopper@example.com",
    timestamp: "1735689600",
    signature: "9f86d081...",
  },
})

Request

require "meisei"

meisei = Meisei::WidgetClient.new(
  publishable_key: "pk_YOUR_PUBLISHABLE_KEY",
  base_url: "https://your-store.meisei.app/api",
)

result = meisei.wishlists.items.delete(
  "A4Ws1igz",
  "A4Ws1igz",
  customer_email: "shopper@example.com",
  timestamp: "1735689600",
  signature: "9f86d081...",
)

Request

from meisei import WidgetClient

meisei = WidgetClient(
    publishable_key="pk_YOUR_PUBLISHABLE_KEY",
    base_url="https://your-store.meisei.app/api",
)

result = meisei.wishlists.items.delete(
    "A4Ws1igz",
    "A4Ws1igz",
    customer_email="shopper@example.com",
    timestamp="1735689600",
    signature="9f86d081...",
)

Response

{
  "wishlist": {
    "id": "A4Ws1igz",
    "name": "string",
    "itemsCount": 0,
    "shared": true,
    "shareUrl": "https://example.com",
    "shareToken": "string",
    "isDefault": true,
    "createdAt": "2025-01-15T09:30:00Z",
    "updatedAt": "2025-01-15T09:30:00Z",
    "items": [
      {
        "id": "...",
        "productId": "...",
        "productVariantId": "...",
        "quantity": "...",
        "note": "...",
        "imageUrl": "...",
        "purchasedQuantity": "...",
        "createdAt": "...",
        "product": "...",
        "variant": "..."
      }
    ]
  },
  "sharingEnabled": true,
  "multipleWishlists": true,
  "itemImagesEnabled": true
}

Response schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "wishlist": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "Unique identifier for the wishlist.",
          "idCodec": "sqid"
        },
        "name": {
          "type": "string"
        },
        "itemsCount": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "shared": {
          "type": "boolean",
          "description": "Whether anyone with the share link can view the wishlist."
        },
        "shareUrl": {
          "type": "string",
          "format": "uri",
          "description": "The public link to the wishlist. It only works while the wishlist is shared."
        },
        "shareToken": {
          "type": "string",
          "description": "The token in the share link, for building a product link that opens with the shopper's photo and note: `?meiseiWishlist=<shareToken>&meiseiItem=<itemId>`. Only meaningful while the wishlist is shared."
        },
        "isDefault": {
          "type": "boolean",
          "description": "Whether this is the customer's default wishlist, the one one-click saves go to."
        },
        "createdAt": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
        },
        "updatedAt": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
        },
        "items": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "Unique identifier for the wishlist item.",
                "idCodec": "sqid"
              },
              "productId": {
                "type": "string",
                "description": "The product saved to the wishlist.",
                "idCodec": "sqid"
              },
              "productVariantId": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "The variant saved, or null for the product as a whole.",
                    "idCodec": "sqid"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "The variant saved, or null for the product as a whole."
              },
              "quantity": {
                "anyOf": [
                  {
                    "type": "integer",
                    "minimum": -9007199254740991,
                    "maximum": 9007199254740991
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "How many of this item the customer wants, or null if they did not say."
              },
              "note": {
                "type": "string",
                "description": "The customer's note about this item, such as a size or color preference."
              },
              "imageUrl": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "The customer's own photo of the item, to show in place of the product image, or null if they added none or the store has photos switched off."
              },
              "purchasedQuantity": {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991,
                "description": "How many of this item the customer has bought themselves."
              },
              "createdAt": {
                "type": "string",
                "format": "date-time",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
              },
              "product": {
                "type": "object",
                "properties": {
                  "slug": {
                    "type": "string"
                  },
                  "title": {
                    "type": "string"
                  },
                  "imageUrl": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "url": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "URL of the product's page on the storefront, or null if it is not known."
                  },
                  "metadata": {
                    "type": "object",
                    "propertyNames": {
                      "type": "string"
                    },
                    "additionalProperties": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "number"
                        },
                        {
                          "type": "boolean"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ],
                      "description": "A metadata value: a string, a number, true or false, or a list of strings. A key with a metadata definition holds the type its definition names."
                    },
                    "description": "The record's custom fields that are shown on the storefront, keyed by field key. Only fields with `storefront` switched on in `/metadata-definitions` appear, and a field with no value is left out."
                  }
                },
                "required": ["slug", "title", "imageUrl", "url", "metadata"],
                "additionalProperties": false
              },
              "variant": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string",
                        "description": "Unique identifier for the variant.",
                        "idCodec": "sqid"
                      },
                      "slug": {
                        "type": "string"
                      },
                      "title": {
                        "type": "string"
                      },
                      "metadata": {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "array",
                              "items": {
                                "type": "string"
                              }
                            }
                          ],
                          "description": "A metadata value: a string, a number, true or false, or a list of strings. A key with a metadata definition holds the type its definition names."
                        },
                        "description": "The record's custom fields that are shown on the storefront, keyed by field key. Only fields with `storefront` switched on in `/metadata-definitions` appear, and a field with no value is left out."
                      }
                    },
                    "required": ["id", "slug", "title", "metadata"],
                    "additionalProperties": false
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "required": [
              "id",
              "productId",
              "productVariantId",
              "quantity",
              "note",
              "imageUrl",
              "purchasedQuantity",
              "createdAt",
              "product",
              "variant"
            ],
            "additionalProperties": false
          }
        }
      },
      "required": [
        "id",
        "name",
        "itemsCount",
        "shared",
        "shareUrl",
        "shareToken",
        "isDefault",
        "createdAt",
        "updatedAt",
        "items"
      ],
      "additionalProperties": false
    },
    "sharingEnabled": {
      "type": "boolean",
      "description": "Whether this store allows wishlist sharing at all. When false, hide every share control."
    },
    "multipleWishlists": {
      "type": "boolean",
      "description": "Whether this store lets a customer keep several wishlists. When false, everything they save goes on one list, so hide the controls for creating or naming another. Lists a customer already holds keep working either way."
    },
    "itemImagesEnabled": {
      "type": "boolean",
      "description": "Whether this store lets a signed-in customer attach their own photo to a saved item. When false, hide the photo picker; any photo already on an item comes back as null."
    }
  },
  "required": ["wishlist", "sharingEnabled", "multipleWishlists", "itemImagesEnabled"],
  "additionalProperties": false
}

#Wishlists

GET /widgets/wishlists/for-product

Query parameters

POST /widgets/wishlists/claim

Query parameters

Body parameters

POST /widgets/wishlists/upload-url

Query parameters

Body parameters

GET /widgets/wishlists/banner

Query parameters

POST /widgets/wishlists/default/toggle-item

Query parameters

Body parameters

GET /widgets/wishlists

Query parameters

POST /widgets/wishlists

Query parameters

Body parameters

GET /widgets/wishlists/{id}

Path parameters

Query parameters

PATCH /widgets/wishlists/{id}

Path parameters

Query parameters

Body parameters

DELETE /widgets/wishlists/{id}

Path parameters

Query parameters

POST /widgets/wishlists/{id}/share-token

Path parameters

Query parameters

POST /widgets/wishlists/{id}/items

Path parameters

Query parameters

Body parameters

PATCH /widgets/wishlists/{id}/items/{itemId}

Path parameters

Query parameters

Body parameters

DELETE /widgets/wishlists/{id}/items/{itemId}

Path parameters

Query parameters

Wishlists

GET `/widgets/wishlists/for-product`

POST `/widgets/wishlists/claim`

POST `/widgets/wishlists/upload-url`

GET `/widgets/wishlists/banner`

POST `/widgets/wishlists/default/toggle-item`

GET `/widgets/wishlists`

POST `/widgets/wishlists`

GET `/widgets/wishlists/{id}`

PATCH `/widgets/wishlists/{id}`

DELETE `/widgets/wishlists/{id}`

POST `/widgets/wishlists/{id}/share-token`

POST `/widgets/wishlists/{id}/items`

PATCH `/widgets/wishlists/{id}/items/{itemId}`

DELETE `/widgets/wishlists/{id}/items/{itemId}`