Create Alert Request

Our app provides a JS widget that is compatible with Cornerstone and themes that have similar markup. With incompatible themes, there will be some development work required in order to be able to show the back-in-stock alerts form on the product detail page when an item or variant is out of stock. 

One approach is to implement the frontend component yourself and send alert requests directly to our storefront API.

Create Alert Request



  • store_hash: string;
    • This is your store identifier, typically find in the URL of your BigCommerce admin panel. 


  • first_name?: string;
  • last_name?: string;
  • email: string;
  • newsletter?: boolean;
  • channel_id: number;
  • customer_id: number | null;
  • currency_id: number | null;
  • product_id: number | string;
  • product_variant_sku: string | null;


  "email":"[email protected]",




  • data: AlertRequest; 
    • id: number;
    • channel_id: number;
    • created_at: string;
    • customer: Customer;
      • email: string;
    • order_total: string
  "data": {
    "id": 65,
    "channel_id": 1,
    "created_at": "2023-01-19 09:32:16",
    "customer": {
      "email": "[email protected]"
    "order_total": "\u00a30"},


Invalid request, e.g. 422: Unable to create alert request, e.g. email address is already subscribed to alerts for this product.

  • errors:
    • email?: string[]
    • channel_id?: string[]
    • customer_id?: string[]
    • currency_id?: string[]
    • product_id?: string[]
    • product_variant_sku?: string[]
    • first_name?: string[]
    • last_name?: string[]
    • newsletter?: string[]
  • message: string
  "message": "You are already subscribed to alerts for this product.",
  "errors": {
    "email": [
      "You are already subscribed to alerts for this product."
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