# Aviso de vuelta a stock (/es/api-reference/public-api/backInStock)

`POST /v1/back-in-stock`

Base URL: `https://api.bitelio.com`

Registra que un visitante de la tienda quiere que le avisen cuando una variante de Shopify agotada vuelva a estar disponible.

Se autentica con tu clave **pública**, porque está pensada para llamarse desde un widget en la tienda. Limitada a 20 peticiones por minuto.

Pedir un aviso **no** es consentimiento de marketing: el contacto se crea sin suscribir, igual que un contacto creado por la API transaccional. El consentimiento se pide aparte.

Devuelve **404** si la variante no es de tu proyecto.

## Request body

- `email`: string (email) (required) — Email del visitante. Si es nuevo se crea como contacto, sin suscribir.
- `shopifyVariantId`: string (required) — Variante de Shopify: el id numérico a secas o el `gid://shopify/ProductVariant/…` completo.

Example:

```json
{
  "email": "user@example.com",
  "shopifyVariantId": "45123456789012"
}
```

## Responses

### `202` — Petición registrada

- `subscribed`: boolean

```json
{
  "subscribed": false
}
```

### `400` — El cuerpo no pasó la validación

### `404` — No existe esa variante en este proyecto

## Example request

```bash
curl -X POST 'https://api.bitelio.com/v1/back-in-stock' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"email":"user@example.com","shopifyVariantId":"45123456789012"}'
```