Skip to main content

Restock Events in Postscript

This page breaks down the event properties you can expect to populate in Restock's Postscript custom event payloads — and use as triggers, conditions, and dynamic merge tags in SMS journeys.

What are Restock's Postscript events?

Once your Postscript integration is connected and Restock is enabled, Unveild fires custom subscriber events into your Postscript account whenever a product changes state (inventory or price) and there are eligible subscribers who showed intent on that product within the lookback window.

Restock sends 3 events to Postscript. The internal trigger logic is identical to the Klaviyo side — only the event name and payload shape change per ESP.

Trigger ActionTrigger DelayPostscript Event
Product variant's inventory crosses back above zeroReal-timeBackInStockUnveild
Product variant's inventory crosses below the configured low-stock thresholdReal-timeLowStockUnveild
Product variant's price drops past the configured thresholdReal-timePriceDropUnveild
note

Postscript events are keyed to the subscriber's phone number, normalized to E.164. Unveild first builds the audience against Klaviyo profile IDs (using intent signals), then looks up each profile's phone number from Klaviyo before sending to Postscript. Profiles without a resolvable phone number are skipped.

Event properties in Restock events

Each event is delivered to Postscript's endpoint with this envelope:

  • type — the Postscript event name (e.g. BackInStockUnveild)
  • email — the subscriber's email if available (still useful as a secondary identifier)
  • occurred_at — ISO-8601 timestamp of the event
  • properties — the event-specific payload, described below

Shared root properties

  • id / ProductID — Shopify product ID
  • VariantID — Shopify variant ID
  • SkuID — variant SKU
  • Name / title / untranslatedTitle — product name
  • VariantName — variant title
  • type — Shopify product type
  • Brand / vendor — Shopify vendor
  • URL / url — product page URL (use either for SMS link templates)
  • ImageURL — variant image URL (with product-image / null fallback)
  • Price — current variant price
  • source — always "restock_unveild"

BackInStockUnveild

No additional properties beyond the shared root.

LowStockUnveild

  • previousQty — inventory level before the update
  • currentQty — inventory level after the update

PriceDropUnveild

  • currentPrice — variant price after the change
  • previousPrice — variant price before the change

Price at the root also carries the current price.

Example payloads

The objects below are the properties value Postscript receives, alongside the type shown in each title.

Back in Stock

BackInStockUnveild
{
"Price": 29.99,
"type": "Apparel",
"id": "8123456789012",
"ProductID": "8123456789012",
"VariantID": "44123456789012",
"url": "https://your-store.com/products/cotton-tee",
"URL": "https://your-store.com/products/cotton-tee",
"SkuID": "TEE-COTTON-M",
"Name": "Cotton Tee",
"title": "Cotton Tee",
"untranslatedTitle": "Cotton Tee",
"VariantName": "Medium",
"Brand": "Your Brand",
"vendor": "Your Brand",
"ImageURL": "https://cdn.shopify.com/s/files/.../cotton-tee.jpg",
"source": "restock_unveild"
}

Low Stock

LowStockUnveild
{
"Price": 29.99,
"type": "Apparel",
"id": "8123456789012",
"ProductID": "8123456789012",
"VariantID": "44123456789012",
"url": "https://your-store.com/products/cotton-tee",
"URL": "https://your-store.com/products/cotton-tee",
"SkuID": "TEE-COTTON-M",
"Name": "Cotton Tee",
"title": "Cotton Tee",
"untranslatedTitle": "Cotton Tee",
"VariantName": "Medium",
"Brand": "Your Brand",
"vendor": "Your Brand",
"ImageURL": "https://cdn.shopify.com/s/files/.../cotton-tee.jpg",
"previousQty": 25,
"currentQty": 3,
"source": "restock_unveild"
}

Price Drop

PriceDropUnveild
{
"Price": 19.99,
"type": "Apparel",
"id": "8123456789012",
"ProductID": "8123456789012",
"VariantID": "44123456789012",
"url": "https://your-store.com/products/cotton-tee",
"URL": "https://your-store.com/products/cotton-tee",
"SkuID": "TEE-COTTON-M",
"Name": "Cotton Tee",
"title": "Cotton Tee",
"untranslatedTitle": "Cotton Tee",
"VariantName": "Medium",
"Brand": "Your Brand",
"vendor": "Your Brand",
"ImageURL": "https://cdn.shopify.com/s/files/.../cotton-tee.jpg",
"currentPrice": 19.99,
"previousPrice": 29.99,
"source": "restock_unveild"
}