Migration Rest Portal

Build Apps

Go Headless

Client

API Preview

Develop Websites

REST

GraphQL (Alpha)

Retrieves back in stock request settings.

import { createClient } from '@wix/sdk';
import { dashboard } from '@wix/dashboard';
import { backInStockSettings } from '@wix/ecom';

const wixClient = createClient({
  modules: { backInStockSettings },
  auth: dashboard.auth(),
  host: dashboard.host()
  })
});

async function getSettings() {
  const response = await wixClient.backInStockSettings.getSettings();
}

getSettings() with Dashboard app access

import { createClient, OAuthStrategy } from '@wix/sdk';
import { backInStockSettings } from '@wix/ecom';

const wixClient = createClient({
  modules: { backInStockSettings } ,
  auth: OAuthStrategy({ clientId: 'MY-CLIENT-ID' })
});

async function getSettings() {
  const response = await wixClient.backInStockSettings.getSettings();
}

getSettings() with visitor/member access

getSettings

GetSettingsResponse

ID of the app to start accepting notification requests for.

appId

string

Sets `settings.collectionStates.collectingRequests` to `true` for given `appId`.

When the collection state is set to `true`, collecting requests is enabled and customers may request
notifications for out of stock products. While collecting is enabled, customers see a "Notify When Available"
button on out-of-stock items. Customers can click the button to enter their email address, which creates the
notification request.

import { createClient } from '@wix/sdk';
import { dashboard } from '@wix/dashboard';
import { backInStockSettings } from '@wix/ecom';

const wixClient = createClient({
  modules: { backInStockSettings },
  auth: dashboard.auth(),
  host: dashboard.host()
  })
});

async function startCollectingRequests(appId) {
  const response = await wixClient.backInStockSettings.startCollectingRequests(appId);
}

startCollectingRequests() with Dashboard app access

startCollectingRequests

StartCollectingRequestsResponse

ID of the app to stop accepting notification requests for.

Sets `settings.collectionStates.collectingRequests` to `false` for given `appId`.

When the collection state is set to `false`, collecting notification requests is disabled.

import { createClient } from '@wix/sdk';
import { dashboard } from '@wix/dashboard';
import { backInStockSettings } from '@wix/ecom';

const wixClient = createClient({
  modules: { backInStockSettings },
  auth: dashboard.auth(),
  host: dashboard.host()
  })
});

async function stopCollectingRequests(appId) {
  const response = await wixClient.backInStockSettings.stopCollectingRequests(appId);
}

stopCollectingRequests() with Dashboard app access

stopCollectingRequests

StopCollectingRequestsResponse

---
title: Introduction
---

# Introduction

The Back In Stock Settings API allows you to manage whether or not to collect requests from customers to receive back in stock notifications. 

Learn more about [back in stock notification settings](https://support.wix.com/en/article/wix-stores-notifying-customers-when-products-are-back-in-stock#collecting-customer-requests).

## Before you begin

It’s important to note the following points before starting to code:
+ To start collecting back in stock requests, the `collectionStates` must be set to `true`. Use [`startCollectingRequests()`](https://dev.wix.com/docs/sdk/api-reference/ecom/back-in-stock-settings/start-collecting-requests) to update collection states.
+ [Customize the design of the notification email](https://support.wix.com/en/article/wix-stores-notifying-customers-when-products-are-back-in-stock#customizing-the-notification-email) that will be sent.

## Terminology

+ **Collection state:** The collection state determines whether the selected app is actively collecting requests for back in stock notifications. When the collection state is set to `true``, collecting requests is enabled and customers may request notifications for out of stock products.


To use the BackInStockSettings API, install the `@wix/ecom` package using npm or Yarn:
  ```console
npm install @wix/ecom
```

or

```console
yarn add @wix/ecom
```

Then import `{ backInStockSettings }` from `@wix/ecom`:

```js
import { backInStockSettings } from '@wix/ecom'
```
  

ecom_back-in-stock-settings

BackInStockCollectionState

ID of the app to receive notification requests for.

Whether to collect requests for items from this app.

collectingRequests

boolean

BackInStockSettings

Information about collecting customer requests to receive
back in stock notifications.

collectionStates

Retrieved back in stock request settings.

Introduction

Before you begin

Terminology

Setup