Skip to content

Resubscribe a customer

API v2 is in public beta: endpoints and fields can change before general availability. See the changelog

POST/back_in_stock/customers/{id}/subscribe

Costs 2 rate-limit points · Rate limits

Subscribe a customer to back-in-stock notifications again, with all their signups, as the customer page's Subscribe does.

Clears unsubscribed_at on the customer and their signups. Already subscribed is a no-op.

Also searched asresubscribe customersubscribe customerturn notifications back on for customer

Path parameters

Headers

  • Idempotency-Keystring

    A fresh unique key for every write (a new UUID, say); reuse it only to retry that write. Keys are remembered for 1 hour: the same key and the same request within that hour returns the first result, with Idempotent-Replayed: true, without running again; the same key with a different method, path or body is refused (422 idempotency_key_reused); a retry while the first is still running gets 409 idempotency_key_in_progress. Keys are per store. Server errors and rate limits are not kept, so their retry runs.

Returns

The customer object.

Errors

404
not_found

The path is valid but nothing with that id exists in this store.

409
idempotency_key_in_progress

An earlier request with the same Idempotency-Key is still running. Wait, then resend the same request with the same key.

422
validation_failed

The request failed validation.

Any request can also fail with auth_invalid (401) or rate_limited (429).

Every error has the same shape: see Errors and the list of error codes.

POST/back_in_stock/customers/{id}/subscribe
curl -X POST "https://app.stoqapp.com/api/v2/external/back_in_stock/customers/string/subscribe" \
  -H "X-Auth-Token: $STOQ_API_KEY"
Response
{
  "id": "8b6f1e2a-0c4d-4f7a-b1e3-9d2c5a7f6e10",
  "name": "John Doe",
  "email": "john@example.com",
  "phone": "+14155550123",
  "accepts_marketing": false,
  "unsubscribed_at": null,
  "created_at": "2026-06-25T13:45:30Z"
}