---
title: "Back in Stock"
description: "Back in Stock: Create customer intent to buy product, Delete intents (single or multiple), Get a specific intent, Get products in demand report, List and filter intents, Notify a single intent, Notify multiple intents in"
url: https://docs.stoqapp.com/v1/back-in-stock/
api: "API v1 (legacy)"
---

# Back in Stock

## The back in stock object

- `id` (string): Unique identifier for the intent
- `blocked_at` (string, nullable): Timestamp when the intent was blocked from sending
- `channel` (string): Communication channel used for notifications (e.g., Email, SMS)
- `email` (string): Customer's email address for notifications
- `notified_at` (string, nullable): Timestamp of the notification sent
- `optin_confirmed` (boolean): Whether the customer has confirmed their GDPR opt-in for notifications
- `phone` (string): Customer's phone number for SMS notifications
- `quantity` (integer): Requested quantity of the product when back in stock
- `sent_notifications_count` (integer): Number of notifications sent for this intent
- `source` (string): e.g. `api`
- `type` (string): Type of the intent (e.g., restock, wishlist_reminder)
- `unsubscribed_at` (string, nullable): Timestamp when the customer unsubscribed from notifications
- `created_at` (string): Timestamp when the intent was created
- `updated_at` (string): Timestamp when the intent was last updated
- `customer_id` (string): Unique identifier for the customer
- `intent_trigger_id` (string, nullable): Identifier for the trigger that created this intent
- `product_variant_id` (string, nullable): Internal product variant identifier
- `shop_id` (string): Unique identifier for the shop
- `shopify_inventory_item_id` (integer, nullable): Shopify's inventory item identifier
- `shopify_market_id` (integer, nullable): Shopify's market identifier for multi-market stores
- `shopify_product_id` (integer, nullable): Shopify's product identifier
- `shopify_variant_id` (integer, nullable): Shopify's variant identifier
- `customer_name` (string, nullable): Customer's full name
- `contact` (string, nullable): Customer's contact information
- `customer_unsubscribed_at` (string, nullable): Timestamp when the customer unsubscribed from all notifications
- `accepts_marketing` (boolean, nullable): Whether the customer has opted in to receive marketing communications
- `notifications_count` (integer, nullable): Total number of notifications sent for this intent

```json
{
  "id": "8f3c2b1a-7d4e-4c2a-9f10-2b3c4d5e6f70",
  "channel": "email",
  "email": "shopper@example.com",
  "phone": null,
  "quantity": 1,
  "notified_at": null,
  "optin_confirmed": true,
  "source": "api",
  "type": "restock",
  "sent_notifications_count": 0,
  "created_at": "2026-06-20T14:30:00Z",
  "updated_at": "2026-06-20T14:30:00Z",
  "customer_id": "c1d2e3f4-5a6b-7c8d-9e0f-1a2b3c4d5e6f",
  "shop_id": "a1b2c3d4-5e6f-7081-92a3-b4c5d6e7f809",
  "shopify_product_id": 7891234567890,
  "shopify_variant_id": 43900910010503,
  "accepts_marketing": true
}
```

## Endpoints

- `POST /intents.json`: [Create customer intent to buy product](https://docs.stoqapp.com/v1/back-in-stock/create-customer-intent-to-buy-product.md)
- `DELETE /external/intents/bulk_destroy`: [Delete intents (single or multiple)](https://docs.stoqapp.com/v1/back-in-stock/delete-intents-single-or-multiple.md)
- `GET /external/intents/{id}`: [Get a specific intent](https://docs.stoqapp.com/v1/back-in-stock/get-a-specific-intent.md)
- `GET /external/intents/products_in_demand`: [Get products in demand report](https://docs.stoqapp.com/v1/back-in-stock/get-products-in-demand-report.md)
- `GET /external/intents`: [List and filter intents](https://docs.stoqapp.com/v1/back-in-stock/list-and-filter-intents.md)
- `POST /external/intents/notify_intent`: [Notify a single intent](https://docs.stoqapp.com/v1/back-in-stock/notify-a-single-intent.md)
- `POST /external/intents/bulk_notify_intent`: [Notify multiple intents in bulk](https://docs.stoqapp.com/v1/back-in-stock/notify-multiple-intents-in-bulk.md)
- `POST /external/intents/transfer_signups`: [Transfer signups from one variant to another](https://docs.stoqapp.com/v1/back-in-stock/transfer-signups-from-one-variant-to-another.md)