Skip to content

Resend opt-in emails

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

POST/back_in_stock/signups/resend_optin

Costs 2 rate-limit points · Rate limits

Re-send the double opt-in (GDPR consent) confirmation email to every unconfirmed signup waiting on a variant or product, as the dashboard's Re-send confirmation does. It cannot target one customer or signup: never offer a resend to a single contact.

Give shopify_variant_id or shopify_product_id. 202 with signups_count, how many unconfirmed pending signups were queued; each email goes to the signup's customer email address. 422 when double opt-in is turned off.

Also searched asresend confirmationresend opt-in emailresend gdpr consent emailremind customers to confirm their signupresend double opt-in

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.

Request body

  • shopify_variant_idstring

    Shopify variant gid whose unconfirmed signups get the email. Give this or shopify_product_id.

  • shopify_product_idstring

    Shopify product gid whose unconfirmed signups get the email. Give this or shopify_variant_id.

Returns

  • signups_countinteger

    Unconfirmed pending signups whose confirmation email was queued.

Errors

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 action refused the request for a reason that is not a single bad field.

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/signups/resend_optin
curl -X POST "https://app.stoqapp.com/api/v2/external/back_in_stock/signups/resend_optin" \
  -H "X-Auth-Token: $STOQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "shopify_variant_id": "gid://shopify/ProductVariant/47284734423096"
  }'
Response
{
  "signups_count": 12
}