Back in Stock Create Endpoint

The endpoint is https://app.backinstock.org/stock_notification/create.json. We expect a GET request with the following params:

  • shop: brand.myshopify.com
  • notification[email]: [email protected]
  • notification[product_no]: 1234567 (Product ID issued by Shopify)
  • notification[quantity_required]: 1 (how many unit of stock the customer if after. Must be at least 1)
  • notification[accepts_marketing]: true (if customer wishes to be subscribed to the shop's mailing lists)
  • notification[customer_utc_offset]: 10800 (browser's UTC offset in seconds)
  • variant[variant_no]: 9876543 (Variant ID issued by Shopify)

Example request:

https://app.backinstock.org/stock_notification/create.json?shop=brand.myshopify.com&notification[email][email protected]&notification[product_no]=1234567&notification[quantity_required]=1&notification[accepts_marketing]=true&notification[customer_utc_offset]=10800&variant[variant_no]=9876543

More info on those fields can be found: https://help.backinstock.org/article/81-javascript-api. Please note that this is an internal endpoint only used by our JavaScript lib. We make a best effort to not introduce any breaking changes but we can't guarantee it will never happen.

Special characters

Note that some characters need to be escaped in the URL. For example, the plus sign + is considered whitespace in URLs, and needs to be replaced with %2B.

You can find a detailed explanation about URL encoding at https://www.urlencoder.io/learn/.

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Still need help? Contact Us Contact Us