Introduction

The MiB Wishlist API lets you fully recreate the wishlist experience in any storefront. Use it to manage profiles, items, analytics events, and share links.

Base URL

https://wishlist-prod.mitbetter.com/api/wishlist/

Conventions

• All requests are JSON unless stated otherwise.
• Set Content-Type: application/json for POST/DELETE.
• Use Authorization: Bearer <API_KEY> or X-API-Key: <API_KEY>.
• Errors return JSON with error and optional issues.

Identity

Most endpoints accept an identity object. At least one of customerId or sessionId is required. customerId is the numeric Shopify customer id as a string (for example "8769049329896").

{
  "customerId": "string | null",
  "sessionId": "string | null",
  "email": "string | null",
  "firstName": "string | null",
  "lastName": "string | null",
  "device": "string | null",
  "locale": "string | null"
}

Source types

source values for items and events:

• pdp
• collection
• cart
• wishlist
• email
• other
• pdpSmartSave

Response basics

• profileId identifies the wishlist profile (guest or account).
• itemId identifies a wishlist item.
• Dates are ISO 8601 strings.