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 Action | Trigger Delay | Postscript Event |
|---|---|---|
| Product variant's inventory crosses back above zero | Real-time | BackInStockUnveild |
| Product variant's inventory crosses below the configured low-stock threshold | Real-time | LowStockUnveild |
| Product variant's price drops past the configured threshold | Real-time | PriceDropUnveild |
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 eventproperties— the event-specific payload, described below
Shared root properties
id/ProductID— Shopify product IDVariantID— Shopify variant IDSkuID— variant SKUName/title/untranslatedTitle— product nameVariantName— variant titletype— Shopify product typeBrand/vendor— Shopify vendorURL/url— product page URL (use either for SMS link templates)ImageURL— variant image URL (with product-image /nullfallback)Price— current variant pricesource— always"restock_unveild"
BackInStockUnveild
No additional properties beyond the shared root.
LowStockUnveild
previousQty— inventory level before the updatecurrentQty— inventory level after the update
PriceDropUnveild
currentPrice— variant price after the changepreviousPrice— 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
{
"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
{
"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
{
"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"
}