API Reference

Comingsoon[Beta]

Fired when a shopper explicitly requests to be notified when a currently coming soon product or variant becomes available for again.

✍️

Please contact your CSM or [email protected] to enable this event payload for your store

Objects

  • User[Shopper]
  • Item[Product]
  • Device

Payload

{
    "EventName": "Swym-comingsoon",
    "EventTime": "2024-10-30T07:42:48Z",
    "EventCustomProperties": {}, //cprops
    "EventSource": "collections", 
    "EventChannel": "web",
    "EventExtras": {},
    "User": {
        "UserId": "7shd3456dgey862t5d7s8ej992jd9e",
        "Medium": "email",
        "MediumValue": "[email protected]",
        "Currency": "USD", //Markets fields
        "Country": "US",  //Markets fields
        "Locale": "en"  //Markets fields
    },
    "Item": { //To Be Supported
        "ProductId": 4269834960999,
        "ProductName": "Emma",
        "ProductPrice": 30,
        "ProductQuantity": 20,
        "ProductBrand": "ScarlettHara",
        "ProductCategory": "White",
        "ProductURL": "https://cc-test-store-nemoz.myshopify.com/products/emma?sw-rfr=4e20&swid=LvppBHin4hcnvm4anRUCC3FpUAD7o16nORhMXuYLgGsI57QzTbrR89SCrVtkyBdON9OFjCbZNhskF-5cHkc61A",
        "ProductImageURL": "https://cdn.shopify.com/s/files/1/0029/7772/6510/products/images-8_620x620.jpg?v=1555656217",
        "ProductVariantId": 30774347071591,
        "ProductVariantInfo": "Color Red",
        "ProductVariantSKU": "sku-187-ydh"
    },
    "Device": {
        "DeviceId": "7shd3456dgey862t5d7s8ej992jd9e",
        "DeviceType": "mobile", 
        "DeviceName": "iPhone 12 Pro Max",
        "DeviceOS": "iOS 14.5", 
        "DeviceBrowser": "Safari", 
        "DeviceIP": "192.168.1.1"
    }
}

AttributeDescriptionSupported
EventNameName of the event✅ Yes
EventTimeDate Time✅ Yes
EventCustomPropertiesCustom properties or tags(cprops)✅ Yes
EventSourceOrigin of the event (e.g., pdp, collections)✅ Yes
EventChannelEvent channel (e.g., web, pos)✅ Yes
EventExtrasExtra info supporting event (e.g., web, pos)✅ Yes
AttributeDescriptionSupported
UserIdUnique identifier for the user✅ Yes
MediumType of identifier (e.g., email, sms)✅ Yes
MediumValueActual value of the identifier✅ Yes
CurrencyShopper's local market currency✅ Yes
CountryShopper's local market country✅ Yes
LocaleShopper's market locale✅ Yes
AttributeDescriptionSupported
ProductIdProduct ID✅ Yes
ProductNameName of the product✅ Yes
ProductPricePrice of the product✅ Yes
ProductQuantityQuantity in stock or shown at time of event✅ Yes
ProductBrandBrand of the product✅ Yes
ProductCategoryCategory/Collection✅ Yes
ProductURLProduct URL✅ Yes
ProductImageURLProduct image URL✅ Yes
ProductVariantIdVariant ID of the product✅ Yes
ProductVariantInfoVariant attributes like color, size, etc.✅ Yes
ProductVariantSKUSKU for the product variant✅ Yes
AttributeDescriptionSupported
DeviceIdUnique device identifier✅ Yes
DeviceTypeType of device (mobile, desktop)✅ Yes
DeviceNameName/model of the device✅ Yes
DeviceOSOperating system✅ Yes
DeviceBrowserBrowser used✅ Yes