Open Source Platform for DTC, B2B Commerce, Marketplaces & Omnichannel. REST APIs, TypeScript SDKs, and production-ready Next.js storefront. Self-host it. Own your data. No vendor lock-in. Zero platform fees.
Ruby b2b-commercee-commerceecommerceecommerce-apiecommerce-frameworkecommerce-platformheadlessheadless-commerceheadless-ecommercemarketplacemulti-tenantmulti-vendormulti-vendor-ecommerceopen-sourcespree-commerce
Link matching newsletter subscriber on customer registration
Damian Legawiec278eab9a1a3c
diff --git a/docs/api-reference/admin.yaml b/docs/api-reference/admin.yamlindex 437aad33ec..c4efd269ee 100644--- a/docs/api-reference/admin.yaml+++ b/docs/api-reference/admin.yaml@@ -82,11 +82,11 @@ paths:example:data:- id: admin_UkLWZg9DAJ- email: [email protected]- first_name: Taisha- last_name: Upton- created_at: '2026-05-17T22:57:21.251Z'- updated_at: '2026-05-17T22:57:21.251Z'+ email: [email protected]+ first_name: Harlan+ last_name: Lesch+ created_at: '2026-05-21T18:10:41.219Z'+ updated_at: '2026-05-21T18:10:41.219Z'roles:- id: role_UkLWZg9DAJname: admin@@ -144,11 +144,11 @@ paths:application/json:example:id: admin_UkLWZg9DAJ- email: [email protected]- first_name: Bennie- last_name: Jerde- created_at: '2026-05-17T22:57:21.592Z'- updated_at: '2026-05-17T22:57:21.592Z'+ email: [email protected]+ first_name: Chasity+ last_name: Beer+ created_at: '2026-05-21T18:10:41.591Z'+ updated_at: '2026-05-21T18:10:41.591Z'roles:- id: role_UkLWZg9DAJname: admin@@ -201,11 +201,11 @@ paths:application/json:example:id: admin_UkLWZg9DAJ- email: [email protected]+ email: [email protected]first_name: Renamed- last_name: Casper- created_at: '2026-05-17T22:57:21.878Z'- updated_at: '2026-05-17T22:57:21.895Z'+ last_name: Bednar+ created_at: '2026-05-21T18:10:41.870Z'+ updated_at: '2026-05-21T18:10:41.886Z'roles:- id: role_UkLWZg9DAJname: admin@@ -314,32 +314,32 @@ paths:key_type: publishabletoken_prefix:scopes: []- created_at: '2026-05-17T22:57:22.193Z'- updated_at: '2026-05-17T22:57:22.193Z'+ created_at: '2026-05-21T18:10:42.192Z'+ updated_at: '2026-05-21T18:10:42.192Z'revoked_at:last_used_at:- plaintext_token: pk_U35V1CMjxUn8ZqkAukTSrh6d+ plaintext_token: pk_gPWGMj9NrPRwrj3ETjUDhZ6Hcreated_by_email:- id: key_gbHJdmfrXBname: Backend integrationkey_type: secret- token_prefix: sk_RgQsPziGM+ token_prefix: sk_TmyLov6pZscopes:- write_all- created_at: '2026-05-17T22:57:22.194Z'- updated_at: '2026-05-17T22:57:22.194Z'+ created_at: '2026-05-21T18:10:42.194Z'+ updated_at: '2026-05-21T18:10:42.194Z'revoked_at:last_used_at:plaintext_token:created_by_email:- id: key_EfhxLZ9ck8- name: hic+ name: cumkey_type: secret- token_prefix: sk_K32iSYt2g+ token_prefix: sk_iXrDjuB2escopes:- write_all- created_at: '2026-05-17T22:57:22.194Z'- updated_at: '2026-05-17T22:57:22.194Z'+ created_at: '2026-05-21T18:10:42.196Z'+ updated_at: '2026-05-21T18:10:42.196Z'revoked_at:last_used_at:plaintext_token:@@ -402,15 +402,15 @@ paths:id: key_VqXmZF31wYname: CI keykey_type: secret- token_prefix: sk_AgmxxXG58+ token_prefix: sk_1cPCpa2fhscopes:- read_orders- created_at: '2026-05-17T22:57:22.758Z'- updated_at: '2026-05-17T22:57:22.758Z'+ created_at: '2026-05-21T18:10:42.788Z'+ updated_at: '2026-05-21T18:10:42.788Z'revoked_at:last_used_at:- plaintext_token: sk_AgmxxXG58HsQVeszL9SN8yNm- created_by_email: [email protected]+ plaintext_token: sk_1cPCpa2fhNURLms46geRmdKn+ created_by_email: [email protected]'422':description: validation errorcontent:@@ -496,11 +496,11 @@ paths:key_type: publishabletoken_prefix:scopes: []- created_at: '2026-05-17T22:57:23.047Z'- updated_at: '2026-05-17T22:57:23.047Z'+ created_at: '2026-05-21T18:10:43.090Z'+ updated_at: '2026-05-21T18:10:43.090Z'revoked_at:last_used_at:- plaintext_token: pk_ZsR9RTxoWgMQbCRWVbza9nAi+ plaintext_token: pk_LUy7zvNorgvrfpjfH3wnNoZQcreated_by_email:delete:summary: Delete an API key@@ -590,12 +590,12 @@ paths:id: key_gbHJdmfrXBname: Backend integrationkey_type: secret- token_prefix: sk_9ntyVz4oF+ token_prefix: sk_ksF9pnh8hscopes:- write_all- created_at: '2026-05-17T22:57:23.620Z'- updated_at: '2026-05-17T22:57:23.925Z'- revoked_at: '2026-05-17T22:57:23.923Z'+ created_at: '2026-05-21T18:10:43.654Z'+ updated_at: '2026-05-21T18:10:43.929Z'+ revoked_at: '2026-05-21T18:10:43.928Z'last_used_at:plaintext_token:created_by_email:@@ -650,15 +650,15 @@ paths:- id: coupon_UkLWZg9DAJcode: AAA111state: unused- created_at: '2026-05-17T22:57:23.946Z'- updated_at: '2026-05-17T22:57:23.946Z'+ created_at: '2026-05-21T18:10:43.945Z'+ updated_at: '2026-05-21T18:10:43.945Z'promotion_id: promo_UkLWZg9DAJorder_id:- id: coupon_gbHJdmfrXBcode: BBB222state: unused- created_at: '2026-05-17T22:57:23.947Z'- updated_at: '2026-05-17T22:57:23.947Z'+ created_at: '2026-05-21T18:10:43.946Z'+ updated_at: '2026-05-21T18:10:43.946Z'promotion_id: promo_UkLWZg9DAJorder_id:meta:@@ -736,8 +736,8 @@ paths:field_type: short_textresource_type: Spree::Productstorefront_visible: true- created_at: '2026-05-17T22:57:24.250Z'- updated_at: '2026-05-17T22:57:24.250Z'+ created_at: '2026-05-21T18:10:44.235Z'+ updated_at: '2026-05-21T18:10:44.235Z'- id: cfdef_gbHJdmfrXBnamespace: customkey: order_notes@@ -745,8 +745,8 @@ paths:field_type: short_textresource_type: Spree::Orderstorefront_visible: true- created_at: '2026-05-17T22:57:24.251Z'- updated_at: '2026-05-17T22:57:24.251Z'+ created_at: '2026-05-21T18:10:44.235Z'+ updated_at: '2026-05-21T18:10:44.235Z'meta:page: 1limit: 25@@ -809,8 +809,8 @@ paths:field_type: short_textresource_type: Spree::Productstorefront_visible: true- created_at: '2026-05-17T22:57:24.816Z'- updated_at: '2026-05-17T22:57:24.816Z'+ created_at: '2026-05-21T18:10:44.787Z'+ updated_at: '2026-05-21T18:10:44.787Z'requestBody:content:application/json:@@ -893,8 +893,8 @@ paths:field_type: short_textresource_type: Spree::Productstorefront_visible: true- created_at: '2026-05-17T22:57:24.818Z'- updated_at: '2026-05-17T22:57:24.818Z'+ created_at: '2026-05-21T18:10:44.789Z'+ updated_at: '2026-05-21T18:10:44.789Z'patch:summary: Update a custom field definitiontags:@@ -933,8 +933,8 @@ paths:field_type: short_textresource_type: Spree::Productstorefront_visible: false- created_at: '2026-05-17T22:57:25.103Z'- updated_at: '2026-05-17T22:57:25.399Z'+ created_at: '2026-05-21T18:10:45.065Z'+ updated_at: '2026-05-21T18:10:45.349Z'requestBody:content:application/json:@@ -1058,14 +1058,14 @@ paths:name: VIPsdescription: Top spenderscustomers_count: 0- created_at: '2026-05-17T22:57:25.696Z'- updated_at: '2026-05-17T22:57:25.696Z'+ created_at: '2026-05-21T18:10:45.641Z'+ updated_at: '2026-05-21T18:10:45.641Z'- id: cg_gbHJdmfrXBname: Wholesaledescription:customers_count: 0- created_at: '2026-05-17T22:57:25.697Z'- updated_at: '2026-05-17T22:57:25.697Z'+ created_at: '2026-05-21T18:10:45.641Z'+ updated_at: '2026-05-21T18:10:45.641Z'meta:page: 1limit: 25@@ -1150,8 +1150,8 @@ paths:name: Wholesale 2description: B2B accountscustomers_count: 1- created_at: '2026-05-17T22:57:26.563Z'- updated_at: '2026-05-17T22:57:26.563Z'+ created_at: '2026-05-21T18:10:46.497Z'+ updated_at: '2026-05-21T18:10:46.497Z'schema:"$ref": "#/components/schemas/CustomerGroup"'422':@@ -1257,24 +1257,24 @@ paths:name: VIPsdescription: Top spenderscustomers_count: 1- created_at: '2026-05-17T22:57:27.194Z'- updated_at: '2026-05-17T22:57:27.194Z'+ created_at: '2026-05-21T18:10:47.060Z'+ updated_at: '2026-05-21T18:10:47.060Z'customers:- id: cus_UkLWZg9DAJ- email: [email protected]- first_name: Drucilla- last_name: Mraz+ email: [email protected]+ first_name: Susanna+ last_name: Turnerphone:accepts_email_marketing: false- full_name: Drucilla Mraz+ full_name: Susanna Turneravailable_store_credit_total: '0'display_available_store_credit_total: "$0.00"- login: [email protected]+ login: [email protected]metadata: {}last_sign_in_at:current_sign_in_at:- created_at: '2026-05-17T22:57:27.460Z'- updated_at: '2026-05-17T22:57:27.460Z'+ created_at: '2026-05-21T18:10:47.320Z'+ updated_at: '2026-05-21T18:10:47.320Z'sign_in_count: 0failed_attempts: 0last_sign_in_ip:@@ -1352,8 +1352,8 @@ paths:name: VIP customers (Q1)description: Top spenderscustomers_count: 0- created_at: '2026-05-17T22:57:28.061Z'- updated_at: '2026-05-17T22:57:28.346Z'+ created_at: '2026-05-21T18:10:47.911Z'+ updated_at: '2026-05-21T18:10:48.190Z'schema:"$ref": "#/components/schemas/CustomerGroup"'422':@@ -1506,8 +1506,8 @@ paths:state_name: New Yorklabel:metadata: {}- created_at: '2026-05-17T22:57:29.199Z'- updated_at: '2026-05-17T22:57:29.199Z'+ created_at: '2026-05-21T18:10:49.027Z'+ updated_at: '2026-05-21T18:10:49.027Z'customer_id: cus_UkLWZg9DAJmeta:page: 1@@ -1595,8 +1595,8 @@ paths:state_name: New Yorklabel: Officemetadata: {}- created_at: '2026-05-17T22:57:30.589Z'- updated_at: '2026-05-17T22:57:30.589Z'+ created_at: '2026-05-21T18:10:50.367Z'+ updated_at: '2026-05-21T18:10:50.367Z'customer_id: cus_UkLWZg9DAJrequestBody:content:@@ -1707,8 +1707,8 @@ paths:state_name: New Yorklabel:metadata: {}- created_at: '2026-05-17T22:57:30.858Z'- updated_at: '2026-05-17T22:57:31.401Z'+ created_at: '2026-05-21T18:10:50.635Z'+ updated_at: '2026-05-21T18:10:51.171Z'customer_id: cus_UkLWZg9DAJrequestBody:content:@@ -1841,8 +1841,8 @@ paths:customer_id: cus_UkLWZg9DAJpayment_method_id: pm_UkLWZg9DAJmetadata: {}- created_at: '2026-05-17T22:57:32.516Z'- updated_at: '2026-05-17T22:57:32.516Z'+ created_at: '2026-05-21T18:10:52.250Z'+ updated_at: '2026-05-21T18:10:52.250Z'meta:page: 1limit: 25@@ -1929,8 +1929,8 @@ paths:customer_id: cus_UkLWZg9DAJpayment_method_id: pm_UkLWZg9DAJmetadata: {}- created_at: '2026-05-17T22:57:33.067Z'- updated_at: '2026-05-17T22:57:33.067Z'+ created_at: '2026-05-21T18:10:52.796Z'+ updated_at: '2026-05-21T18:10:52.796Z'delete:summary: Delete a customer credit cardtags:@@ -2049,8 +2049,8 @@ paths:currency: USDmemo:metadata: {}- created_at: '2026-05-17T22:57:34.424Z'- updated_at: '2026-05-17T22:57:34.424Z'+ created_at: '2026-05-21T18:10:54.199Z'+ updated_at: '2026-05-21T18:10:54.199Z'customer_id: cus_UkLWZg9DAJcreated_by_id: admin_UkLWZg9DAJcategory_id: sccat_UkLWZg9DAJ@@ -2125,8 +2125,8 @@ paths:currency: USDmemo: Goodwillmetadata: {}- created_at: '2026-05-17T22:57:35.514Z'- updated_at: '2026-05-17T22:57:35.514Z'+ created_at: '2026-05-21T18:10:55.292Z'+ updated_at: '2026-05-21T18:10:55.292Z'customer_id: cus_UkLWZg9DAJcreated_by_id: admin_gbHJdmfrXBcategory_id: sccat_UkLWZg9DAJ@@ -2217,8 +2217,8 @@ paths:currency: USDmemo: Updatedmetadata: {}- created_at: '2026-05-17T22:57:36.047Z'- updated_at: '2026-05-17T22:57:36.325Z'+ created_at: '2026-05-21T18:10:55.821Z'+ updated_at: '2026-05-21T18:10:56.098Z'customer_id: cus_UkLWZg9DAJcreated_by_id: admin_UkLWZg9DAJcategory_id: sccat_UkLWZg9DAJ@@ -2372,8 +2372,8 @@ paths:metadata: {}last_sign_in_at:current_sign_in_at:- created_at: '2026-05-17T22:57:37.396Z'- updated_at: '2026-05-17T22:57:37.396Z'+ created_at: '2026-05-21T18:10:57.233Z'+ updated_at: '2026-05-21T18:10:57.233Z'sign_in_count: 0failed_attempts: 0last_sign_in_ip:@@ -2456,8 +2456,8 @@ paths:metadata: {}last_sign_in_at:current_sign_in_at:- created_at: '2026-05-17T22:57:38.226Z'- updated_at: '2026-05-17T22:57:38.226Z'+ created_at: '2026-05-21T18:10:58.068Z'+ updated_at: '2026-05-21T18:10:58.068Z'sign_in_count: 0failed_attempts: 0last_sign_in_ip:@@ -2573,8 +2573,8 @@ paths:metadata: {}last_sign_in_at:current_sign_in_at:- created_at: '2026-05-17T22:57:38.506Z'- updated_at: '2026-05-17T22:57:38.506Z'+ created_at: '2026-05-21T18:10:58.336Z'+ updated_at: '2026-05-21T18:10:58.336Z'sign_in_count: 0failed_attempts: 0last_sign_in_ip:@@ -2648,8 +2648,8 @@ paths:metadata: {}last_sign_in_at:current_sign_in_at:- created_at: '2026-05-17T22:57:39.051Z'- updated_at: '2026-05-17T22:57:39.332Z'+ created_at: '2026-05-21T18:10:58.876Z'+ updated_at: '2026-05-21T18:10:59.154Z'sign_in_count: 0failed_attempts: 0last_sign_in_ip:@@ -2728,6 +2728,161 @@ paths:responses:'204':description: customer deleted+ "/api/v3/admin/customers/bulk_add_to_groups":+ post:+ summary: Bulk-add customers to groups+ tags:+ - Customers+ security:+ - api_key: []+ bearer_auth: []+ description: |-+ Attaches each customer in `ids` to every group in `customer_group_ids`.+ Idempotent — customers already in a group are skipped server-side.+ Groups from sibling stores are silently ignored. Returns counts of+ customers and groups that were processed (post store-scoping).+++ **Required scope:** `write_customers` (for API-key authentication).+ x-codeSamples:+ - lang: javascript+ label: Spree Admin SDK+ source: |-+ import { createAdminClient } from '@spree/admin-sdk'++ const client = createAdminClient({+ baseUrl: 'https://your-store.com',+ secretKey: 'sk_xxx',+ })++ const result = await client.customers.bulkAddToGroups({+ ids: ['cus_UkLWZg9DAJ', 'cus_QrLWXg9CAJ'],+ customer_group_ids: ['cg_UkLWZg9DAJ'],+ })+ parameters:+ - name: x-spree-api-key+ in: header+ required: true+ schema:+ type: string+ - name: Authorization+ in: header+ required: true+ schema:+ type: string+ responses:+ '200':+ description: customers added to groups+ content:+ application/json:+ example:+ customer_count: 1+ customer_group_count: 1+ schema:+ type: object+ properties:+ customer_count:+ type: integer+ customer_group_count:+ type: integer+ requestBody:+ content:+ application/json:+ schema:+ type: object+ required:+ - ids+ - customer_group_ids+ properties:+ ids:+ type: array+ items:+ type: string+ example:+ - cus_UkLWZg9DAJ+ - cus_QrLWXg9CAJ+ customer_group_ids:+ type: array+ items:+ type: string+ example:+ - cg_UkLWZg9DAJ+ "/api/v3/admin/customers/bulk_remove_from_groups":+ post:+ summary: Bulk-remove customers from groups+ tags:+ - Customers+ security:+ - api_key: []+ bearer_auth: []+ description: |-+ Detaches each customer in `ids` from every group in `customer_group_ids`.+ No-op for non-members. Groups from sibling stores are silently ignored.+++ **Required scope:** `write_customers` (for API-key authentication).+ x-codeSamples:+ - lang: javascript+ label: Spree Admin SDK+ source: |-+ import { createAdminClient } from '@spree/admin-sdk'++ const client = createAdminClient({+ baseUrl: 'https://your-store.com',+ secretKey: 'sk_xxx',+ })++ const result = await client.customers.bulkRemoveFromGroups({+ ids: ['cus_UkLWZg9DAJ'],+ customer_group_ids: ['cg_UkLWZg9DAJ'],+ })+ parameters:+ - name: x-spree-api-key+ in: header+ required: true+ schema:+ type: string+ - name: Authorization+ in: header+ required: true+ schema:+ type: string+ responses:+ '200':+ description: customers removed from groups+ content:+ application/json:+ example:+ customer_count: 1+ customer_group_count: 1+ schema:+ type: object+ properties:+ customer_count:+ type: integer+ customer_group_count:+ type: integer+ requestBody:+ content:+ application/json:+ schema:+ type: object+ required:+ - ids+ - customer_group_ids+ properties:+ ids:+ type: array+ items:+ type: string+ example:+ - cus_UkLWZg9DAJ+ customer_group_ids:+ type: array+ items:+ type: string+ example:+ - cg_UkLWZg9DAJ"/api/v3/admin/exports":get:summary: List exports@@ -2771,11 +2926,11 @@ paths:example:data:- id: exp_UkLWZg9DAJ- number: EF181505182+ number: EF106832425type: Spree::Exports::Productsformat: csv- created_at: '2026-05-17T22:57:40.165Z'- updated_at: '2026-05-17T22:57:40.165Z'+ created_at: '2026-05-21T18:11:01.605Z'+ updated_at: '2026-05-21T18:11:01.605Z'user_id: admin_UkLWZg9DAJdone: falsefilename:@@ -2842,11 +2997,11 @@ paths:application/json:example:id: exp_gbHJdmfrXB- number: EF196782958+ number: EF378981566type: Spree::Exports::Productsformat: csv- created_at: '2026-05-17T22:57:40.457Z'- updated_at: '2026-05-17T22:57:40.457Z'+ created_at: '2026-05-21T18:11:01.903Z'+ updated_at: '2026-05-21T18:11:01.903Z'user_id: admin_UkLWZg9DAJdone: falsefilename:@@ -2933,11 +3088,11 @@ paths:application/json:example:id: exp_UkLWZg9DAJ- number: EF446204860+ number: EF499734650type: Spree::Exports::Productsformat: csv- created_at: '2026-05-17T22:57:40.725Z'- updated_at: '2026-05-17T22:57:40.725Z'+ created_at: '2026-05-21T18:11:02.171Z'+ updated_at: '2026-05-21T18:11:02.171Z'user_id: admin_UkLWZg9DAJdone: falsefilename:@@ -3088,15 +3243,15 @@ paths:example:data:- id: inv_UkLWZg9DAJ- email: [email protected]+ email: [email protected]status: pending- created_at: '2026-05-17T22:57:41.583Z'- updated_at: '2026-05-17T22:57:41.583Z'- expires_at: '2026-05-31T22:57:41.581Z'+ created_at: '2026-05-21T18:11:03.022Z'+ updated_at: '2026-05-21T18:11:03.022Z'+ expires_at: '2026-06-04T18:11:03.020Z'role_id: role_UkLWZg9DAJrole_name: admin- inviter_email: [email protected]- acceptance_url: "/accept-invitation/inv_UkLWZg9DAJ?token=Sm1UZP3PfJPPUdSmcVoXpAX2"+ inviter_email: [email protected]+ acceptance_url: "/accept-invitation/inv_UkLWZg9DAJ?token=oneuuQSVMG5G4bcVNYPZUQE9"meta:page: 1limit: 25@@ -3153,13 +3308,13 @@ paths:id: inv_gbHJdmfrXBemail: [email protected]status: pending- created_at: '2026-05-17T22:57:41.880Z'- updated_at: '2026-05-17T22:57:41.880Z'- expires_at: '2026-05-31T22:57:41.878Z'+ created_at: '2026-05-21T18:11:03.317Z'+ updated_at: '2026-05-21T18:11:03.317Z'+ expires_at: '2026-06-04T18:11:03.315Z'role_id: role_UkLWZg9DAJrole_name: admin- inviter_email: [email protected]- acceptance_url: "/accept-invitation/inv_gbHJdmfrXB?token=TemhXQKMdCgFXmyPhhDS37sy"+ inviter_email: [email protected]+ acceptance_url: "/accept-invitation/inv_gbHJdmfrXB?token=1Bj17uQWhsg5tYdTVk5amqTA"requestBody:content:application/json:@@ -3262,15 +3417,15 @@ paths:application/json:example:id: inv_UkLWZg9DAJ- email: [email protected]+ email: [email protected]status: pending- created_at: '2026-05-17T22:57:42.445Z'- updated_at: '2026-05-17T22:57:42.445Z'- expires_at: '2026-05-31T22:57:42.442Z'+ created_at: '2026-05-21T18:11:03.882Z'+ updated_at: '2026-05-21T18:11:03.882Z'+ expires_at: '2026-06-04T18:11:03.880Z'role_id: role_UkLWZg9DAJrole_name: admin- inviter_email: [email protected]- acceptance_url: "/accept-invitation/inv_UkLWZg9DAJ?token=e8J3mdcca4TSodmoxqdbCoFi"+ inviter_email: [email protected]+ acceptance_url: "/accept-invitation/inv_UkLWZg9DAJ?token=S6EjxjJWQ3XQhCVm1EhozQQR""/api/v3/admin/me":get:summary: Get current admin user and permissions@@ -3316,11 +3471,11 @@ paths:example:user:id: admin_UkLWZg9DAJ- email: [email protected]- first_name: Delma- last_name: Lind- created_at: '2026-05-17T22:57:42.721Z'- updated_at: '2026-05-17T22:57:42.721Z'+ email: [email protected]+ first_name: Twyla+ last_name: Watsica+ created_at: '2026-05-21T18:11:04.160Z'+ updated_at: '2026-05-21T18:11:04.160Z'roles:- id: role_UkLWZg9DAJname: admin@@ -3470,8 +3625,8 @@ paths:kind: dropdownmetadata: {}filterable: true- created_at: '2026-05-17T22:57:42.762Z'- updated_at: '2026-05-17T22:57:42.762Z'+ created_at: '2026-05-21T18:11:04.205Z'+ updated_at: '2026-05-21T18:11:04.205Z'meta:page: 1limit: 25@@ -3562,8 +3717,8 @@ paths:kind: dropdownmetadata: {}filterable: true- created_at: '2026-05-17T22:57:43.336Z'- updated_at: '2026-05-17T22:57:43.336Z'+ created_at: '2026-05-21T18:11:04.784Z'+ updated_at: '2026-05-21T18:11:04.784Z'schema:"$ref": "#/components/schemas/OptionType"'422':@@ -3684,8 +3839,8 @@ paths:kind: dropdownmetadata: {}filterable: true- created_at: '2026-05-17T22:57:43.621Z'- updated_at: '2026-05-17T22:57:43.621Z'+ created_at: '2026-05-21T18:11:05.069Z'+ updated_at: '2026-05-21T18:11:05.069Z'schema:"$ref": "#/components/schemas/OptionType"'404':@@ -3757,8 +3912,8 @@ paths:kind: dropdownmetadata: {}filterable: true- created_at: '2026-05-17T22:57:44.197Z'- updated_at: '2026-05-17T22:57:44.475Z'+ created_at: '2026-05-21T18:11:05.633Z'+ updated_at: '2026-05-21T18:11:05.926Z'schema:"$ref": "#/components/schemas/OptionType"'422':@@ -3917,7 +4072,7 @@ paths:example:data:- id: ful_UkLWZg9DAJ- number: H93726194260+ number: H55703158790tracking: U10000tracking_url:cost: '10.0'@@ -3942,8 +4097,8 @@ paths:metadata: {}adjustment_total: '0.0'pre_tax_amount: '0.0'- created_at: '2026-05-17T22:57:45.414Z'- updated_at: '2026-05-17T22:57:45.527Z'+ created_at: '2026-05-21T18:11:06.921Z'+ updated_at: '2026-05-21T18:11:07.008Z'order_id: or_UkLWZg9DAJstock_location_id: sloc_UkLWZg9DAJmeta:@@ -4026,7 +4181,7 @@ paths:application/json:example:id: ful_UkLWZg9DAJ- number: H67359691291+ number: H33304075909tracking: U10000tracking_url:cost: '10.0'@@ -4051,8 +4206,8 @@ paths:metadata: {}adjustment_total: '0.0'pre_tax_amount: '0.0'- created_at: '2026-05-17T22:57:46.167Z'- updated_at: '2026-05-17T22:57:46.285Z'+ created_at: '2026-05-21T18:11:07.631Z'+ updated_at: '2026-05-21T18:11:07.686Z'order_id: or_UkLWZg9DAJstock_location_id: sloc_UkLWZg9DAJpatch:@@ -4111,7 +4266,7 @@ paths:application/json:example:id: ful_UkLWZg9DAJ- number: H82376403615+ number: H57005977773tracking: 1Z999AA10123456784tracking_url: https://wwwapps.ups.com/WebTracking/track?track=yes&trackNums=1Z999AA10123456784cost: '10.0'@@ -4136,8 +4291,8 @@ paths:metadata: {}adjustment_total: '0.0'pre_tax_amount: '0.0'- created_at: '2026-05-17T22:57:46.881Z'- updated_at: '2026-05-17T22:57:47.225Z'+ created_at: '2026-05-21T18:11:08.270Z'+ updated_at: '2026-05-21T18:11:08.607Z'order_id: or_UkLWZg9DAJstock_location_id: sloc_UkLWZg9DAJrequestBody:@@ -4206,7 +4361,7 @@ paths:application/json:example:id: ful_UkLWZg9DAJ- number: H42791123467+ number: H64771060776tracking: U10000tracking_url:cost: '10.0'@@ -4223,7 +4378,7 @@ paths:display_tax_total: "$0.00"status: shippedfulfillment_type: shipping- fulfilled_at: '2026-05-17T22:57:47Z'+ fulfilled_at: '2026-05-21T18:11:09Z'items:- item_id: li_UkLWZg9DAJvariant_id: variant_UkLWZg9DAJ@@ -4231,8 +4386,8 @@ paths:metadata: {}adjustment_total: '0.0'pre_tax_amount: '0.0'- created_at: '2026-05-17T22:57:47.543Z'- updated_at: '2026-05-17T22:57:47.892Z'+ created_at: '2026-05-21T18:11:08.923Z'+ updated_at: '2026-05-21T18:11:09.289Z'order_id: or_UkLWZg9DAJstock_location_id: sloc_UkLWZg9DAJ"/api/v3/admin/orders/{order_id}/fulfillments/{id}/cancel":@@ -4290,7 +4445,7 @@ paths:application/json:example:id: ful_UkLWZg9DAJ- number: H68028933136+ number: H29612628564tracking: U10000tracking_url:cost: '10.0'@@ -4315,8 +4470,8 @@ paths:metadata: {}adjustment_total: '0.0'pre_tax_amount: '0.0'- created_at: '2026-05-17T22:57:48.220Z'- updated_at: '2026-05-17T22:57:48.568Z'+ created_at: '2026-05-21T18:11:09.604Z'+ updated_at: '2026-05-21T18:11:09.958Z'order_id: or_UkLWZg9DAJstock_location_id: sloc_UkLWZg9DAJ"/api/v3/admin/orders/{order_id}/fulfillments/{id}/resume":@@ -4374,7 +4529,7 @@ paths:application/json:example:id: ful_UkLWZg9DAJ- number: H18035538721+ number: H32055728452tracking: U10000tracking_url:cost: '10.0'@@ -4399,8 +4554,8 @@ paths:metadata: {}adjustment_total: '0.0'pre_tax_amount: '0.0'- created_at: '2026-05-17T22:57:48.894Z'- updated_at: '2026-05-17T22:57:49.260Z'+ created_at: '2026-05-21T18:11:10.300Z'+ updated_at: '2026-05-21T18:11:10.670Z'order_id: or_UkLWZg9DAJstock_location_id: sloc_UkLWZg9DAJ"/api/v3/admin/orders/{order_id}/fulfillments/{id}/split":@@ -4461,7 +4616,7 @@ paths:example:data:- id: ful_gbHJdmfrXB- number: H42674651588+ number: H90633868146tracking:tracking_url:cost: '10.0'@@ -4486,8 +4641,8 @@ paths:metadata: {}adjustment_total: '0.0'pre_tax_amount: '0.0'- created_at: '2026-05-17T22:57:49.949Z'- updated_at: '2026-05-17T22:57:49.997Z'+ created_at: '2026-05-21T18:11:11.340Z'+ updated_at: '2026-05-21T18:11:11.385Z'order_id: or_UkLWZg9DAJstock_location_id: sloc_gbHJdmfrXBrequestBody:@@ -4559,7 +4714,7 @@ paths:application/json:example:id: gc_UkLWZg9DAJ- code: 0262137AC51DF7BF+ code: 4FE246FA26B40985status: activecurrency: USDamount: '10.0'@@ -4573,8 +4728,8 @@ paths:redeemed_at:expired: falseactive: true- created_at: '2026-05-17T22:57:50.337Z'- updated_at: '2026-05-17T22:57:50.632Z'+ created_at: '2026-05-21T18:11:11.716Z'+ updated_at: '2026-05-21T18:11:12.007Z'requestBody:content:application/json:@@ -4705,8 +4860,8 @@ paths:variant_id: variant_gbHJdmfrXBquantity: 2currency: USD- name: Product 103053- slug: product-103053+ name: Product 10487+ slug: product-10487options_text: 'Size: S'price: '10.0'display_price: "$10.00"@@ -4738,12 +4893,12 @@ paths:option_type_label: Sizeimage_url:metadata: {}- created_at: '2026-05-17T22:57:51.306Z'- updated_at: '2026-05-17T22:57:51.306Z'+ created_at: '2026-05-21T18:11:12.695Z'+ updated_at: '2026-05-21T18:11:12.695Z'digital_links: []metadata: {}- created_at: '2026-05-17T22:57:51.591Z'- updated_at: '2026-05-17T22:57:51.591Z'+ created_at: '2026-05-21T18:11:12.991Z'+ updated_at: '2026-05-21T18:11:12.991Z'cost_price: '17.0'tax_category_id: taxcat_UkLWZg9DAJmeta:@@ -4810,8 +4965,8 @@ paths:variant_id: variant_VqXmZF31wYquantity: 3currency: USD- name: Product 128467- slug: product-128467+ name: Product 126547+ slug: product-126547options_text: 'Size: S'price: '19.99'display_price: "$19.99"@@ -4843,12 +4998,12 @@ paths:option_type_label: Sizeimage_url:metadata: {}- created_at: '2026-05-17T22:57:52.529Z'- updated_at: '2026-05-17T22:57:52.529Z'+ created_at: '2026-05-21T18:11:14.028Z'+ updated_at: '2026-05-21T18:11:14.028Z'digital_links: []metadata: {}- created_at: '2026-05-17T22:57:52.559Z'- updated_at: '2026-05-17T22:57:52.559Z'+ created_at: '2026-05-21T18:11:14.053Z'+ updated_at: '2026-05-21T18:11:14.053Z'cost_price: '17.0'tax_category_id: taxcat_UkLWZg9DAJrequestBody:@@ -4937,8 +5092,8 @@ paths:variant_id: variant_gbHJdmfrXBquantity: 2currency: USD- name: Product 135720- slug: product-135720+ name: Product 133638+ slug: product-133638options_text: 'Size: S'price: '10.0'display_price: "$10.00"@@ -4970,12 +5125,12 @@ paths:option_type_label: Sizeimage_url:metadata: {}- created_at: '2026-05-17T22:57:52.633Z'- updated_at: '2026-05-17T22:57:52.633Z'+ created_at: '2026-05-21T18:11:14.139Z'+ updated_at: '2026-05-21T18:11:14.139Z'digital_links: []metadata: {}- created_at: '2026-05-17T22:57:52.918Z'- updated_at: '2026-05-17T22:57:52.918Z'+ created_at: '2026-05-21T18:11:14.433Z'+ updated_at: '2026-05-21T18:11:14.433Z'cost_price: '17.0'tax_category_id: taxcat_UkLWZg9DAJpatch:@@ -5037,8 +5192,8 @@ paths:variant_id: variant_gbHJdmfrXBquantity: 5currency: USD- name: Product 14367- slug: product-14367+ name: Product 141563+ slug: product-141563options_text: 'Size: S'price: '19.99'display_price: "$19.99"@@ -5070,12 +5225,12 @@ paths:option_type_label: Sizeimage_url:metadata: {}- created_at: '2026-05-17T22:57:53.243Z'- updated_at: '2026-05-17T22:57:53.243Z'+ created_at: '2026-05-21T18:11:14.759Z'+ updated_at: '2026-05-21T18:11:14.759Z'digital_links: []metadata: {}- created_at: '2026-05-17T22:57:53.531Z'- updated_at: '2026-05-17T22:57:53.828Z'+ created_at: '2026-05-21T18:11:15.044Z'+ updated_at: '2026-05-21T18:11:15.352Z'cost_price: '17.0'tax_category_id: taxcat_UkLWZg9DAJrequestBody:@@ -5201,8 +5356,8 @@ paths:data:- id: py_UkLWZg9DAJpayment_method_id: pm_UkLWZg9DAJ- response_code: BGS-0cb507c6b6fd- number: PSQU5GQO+ response_code: BGS-68effea76f43+ number: PA0E91P2amount: '110.0'display_amount: "$110.00"status: completed@@ -5220,14 +5375,14 @@ paths:customer_id:payment_method_id: pm_gbHJdmfrXBmetadata: {}- created_at: '2026-05-17T22:57:54.817Z'- updated_at: '2026-05-17T22:57:54.821Z'+ created_at: '2026-05-21T18:11:16.469Z'+ updated_at: '2026-05-21T18:11:16.471Z'metadata: {}avs_response:cvv_response_code:cvv_response_message:- created_at: '2026-05-17T22:57:54.820Z'- updated_at: '2026-05-17T22:57:54.820Z'+ created_at: '2026-05-21T18:11:16.470Z'+ updated_at: '2026-05-21T18:11:16.470Z'captured_amount: '0.0'order_id: or_UkLWZg9DAJmeta:@@ -5294,7 +5449,7 @@ paths:id: py_gbHJdmfrXBpayment_method_id: pm_EfhxLZ9ck8response_code:- number: PD00W24T+ number: P7NSTYZIamount: '110.0'display_amount: "$110.00"status: checkout@@ -5305,8 +5460,8 @@ paths:avs_response:cvv_response_code:cvv_response_message:- created_at: '2026-05-17T22:57:56.148Z'- updated_at: '2026-05-17T22:57:56.148Z'+ created_at: '2026-05-21T18:11:17.771Z'+ updated_at: '2026-05-21T18:11:17.771Z'captured_amount: '0.0'order_id: or_gbHJdmfrXBrequestBody:@@ -5396,8 +5551,8 @@ paths:example:id: py_UkLWZg9DAJpayment_method_id: pm_UkLWZg9DAJ- response_code: BGS-111160a6f3ed- number: PEQOW0S0+ response_code: BGS-cacbdea24d28+ number: PK9QXUFZamount: '110.0'display_amount: "$110.00"status: completed@@ -5415,14 +5570,14 @@ paths:customer_id:payment_method_id: pm_gbHJdmfrXBmetadata: {}- created_at: '2026-05-17T22:57:56.525Z'- updated_at: '2026-05-17T22:57:56.527Z'+ created_at: '2026-05-21T18:11:18.181Z'+ updated_at: '2026-05-21T18:11:18.184Z'metadata: {}avs_response:cvv_response_code:cvv_response_message:- created_at: '2026-05-17T22:57:56.526Z'- updated_at: '2026-05-17T22:57:56.526Z'+ created_at: '2026-05-21T18:11:18.182Z'+ updated_at: '2026-05-21T18:11:18.182Z'captured_amount: '0.0'order_id: or_UkLWZg9DAJ"/api/v3/admin/orders/{order_id}/payments/{id}/capture":@@ -5481,8 +5636,8 @@ paths:example:id: py_UkLWZg9DAJpayment_method_id: pm_UkLWZg9DAJ- response_code: BGS-f5c608409d35- number: P2IQ5WXV+ response_code: BGS-efbbca6d3e6b+ number: PAP44T33amount: '110.0'display_amount: "$110.00"status: completed@@ -5500,14 +5655,14 @@ paths:customer_id:payment_method_id: pm_gbHJdmfrXBmetadata: {}- created_at: '2026-05-17T22:57:57.172Z'- updated_at: '2026-05-17T22:57:57.175Z'+ created_at: '2026-05-21T18:11:18.837Z'+ updated_at: '2026-05-21T18:11:18.839Z'metadata: {}avs_response:cvv_response_code:cvv_response_message:- created_at: '2026-05-17T22:57:57.174Z'- updated_at: '2026-05-17T22:57:57.517Z'+ created_at: '2026-05-21T18:11:18.838Z'+ updated_at: '2026-05-21T18:11:19.158Z'captured_amount: '110.0'order_id: or_UkLWZg9DAJ'422':@@ -5576,8 +5731,8 @@ paths:example:id: py_UkLWZg9DAJpayment_method_id: pm_UkLWZg9DAJ- response_code: void-BGS-a7822422048d- number: PHHVVBKB+ response_code: void-BGS-df4aa5520eb3+ number: PP2A7W5Uamount: '110.0'display_amount: "$110.00"status: void@@ -5595,14 +5750,14 @@ paths:customer_id:payment_method_id: pm_gbHJdmfrXBmetadata: {}- created_at: '2026-05-17T22:57:58.605Z'- updated_at: '2026-05-17T22:57:58.608Z'+ created_at: '2026-05-21T18:11:20.228Z'+ updated_at: '2026-05-21T18:11:20.230Z'metadata: {}avs_response:cvv_response_code:cvv_response_message:- created_at: '2026-05-17T22:57:58.607Z'- updated_at: '2026-05-17T22:57:58.909Z'+ created_at: '2026-05-21T18:11:20.229Z'+ updated_at: '2026-05-21T18:11:20.539Z'captured_amount: '0.0'order_id: or_UkLWZg9DAJ"/api/v3/admin/orders/{order_id}/refunds":@@ -5730,14 +5885,14 @@ paths:application/json:example:id: re_UkLWZg9DAJ- transaction_id: BGS-1e98d2337e15+ transaction_id: BGS-162d0a7eaecaamount: '5.0'payment_id: py_UkLWZg9DAJrefund_reason_id: rr_UkLWZg9DAJreimbursement_id:metadata: {}- created_at: '2026-05-17T22:58:00.262Z'- updated_at: '2026-05-17T22:58:00.262Z'+ created_at: '2026-05-21T18:11:21.881Z'+ updated_at: '2026-05-21T18:11:21.881Z'requestBody:content:application/json:@@ -5809,8 +5964,8 @@ paths:id: or_UkLWZg9DAJmarket_id:channel_id: ch_UkLWZg9DAJ- number: R421111487- email: [email protected]+ number: R127319008+ email: [email protected]customer_note:currency: USDlocale: en@@ -5853,8 +6008,8 @@ paths:metadata: {}canceled_at:approved_at:- created_at: '2026-05-17T22:58:00.562Z'- updated_at: '2026-05-17T22:58:00.616Z'+ created_at: '2026-05-21T18:11:22.177Z'+ updated_at: '2026-05-21T18:11:22.244Z'preferred_stock_location_id:tags: []internal_note:@@ -6025,8 +6180,8 @@ paths:- id: or_UkLWZg9DAJmarket_id:channel_id: ch_UkLWZg9DAJ- number: R960433554- email: [email protected]+ number: R820326830+ email: [email protected]customer_note:currency: USDlocale: en@@ -6069,8 +6224,8 @@ paths:metadata: {}canceled_at:approved_at:- created_at: '2026-05-17T22:58:02.356Z'- updated_at: '2026-05-17T22:58:02.356Z'+ created_at: '2026-05-21T18:11:23.988Z'+ updated_at: '2026-05-21T18:11:23.988Z'preferred_stock_location_id:tags: []internal_note:@@ -6213,7 +6368,7 @@ paths:id: or_gbHJdmfrXBmarket_id:channel_id: ch_UkLWZg9DAJ- number: R338726767+ number: R134720113email: [email protected]customer_note:currency: USD@@ -6257,8 +6412,8 @@ paths:metadata: {}canceled_at:approved_at:- created_at: '2026-05-17T22:58:04.037Z'- updated_at: '2026-05-17T22:58:04.041Z'+ created_at: '2026-05-21T18:11:25.674Z'+ updated_at: '2026-05-21T18:11:25.677Z'preferred_stock_location_id: sloc_UkLWZg9DAJtags: []internal_note:@@ -6442,8 +6597,8 @@ paths:id: or_UkLWZg9DAJmarket_id:channel_id: ch_UkLWZg9DAJ- number: R077708501- email: [email protected]+ number: R107305096+ email: [email protected]customer_note:currency: USDlocale: en@@ -6486,8 +6641,8 @@ paths:metadata: {}canceled_at:approved_at:- created_at: '2026-05-17T22:58:04.316Z'- updated_at: '2026-05-17T22:58:04.316Z'+ created_at: '2026-05-21T18:11:25.951Z'+ updated_at: '2026-05-21T18:11:25.951Z'preferred_stock_location_id:tags: []internal_note:@@ -6558,7 +6713,7 @@ paths:id: or_UkLWZg9DAJmarket_id:channel_id: ch_UkLWZg9DAJ- number: R719018821+ number: R663137812email: [email protected]customer_note:currency: USD@@ -6602,8 +6757,8 @@ paths:metadata: {}canceled_at:approved_at:- created_at: '2026-05-17T22:58:05.432Z'- updated_at: '2026-05-17T22:58:05.724Z'+ created_at: '2026-05-21T18:11:27.065Z'+ updated_at: '2026-05-21T18:11:27.352Z'preferred_stock_location_id:tags: []internal_note:@@ -6784,8 +6939,8 @@ paths:id: or_UkLWZg9DAJmarket_id:channel_id: ch_UkLWZg9DAJ- number: R016462732- email: [email protected]+ number: R388861139+ email: [email protected]customer_note:currency: USDlocale: en@@ -6812,7 +6967,7 @@ paths:display_delivery_total: "$100.00"fulfillment_status: readypayment_status: paid- completed_at: '2026-05-17T22:58:06.625Z'+ completed_at: '2026-05-21T18:11:28.250Z'store_credit_total: '0.0'display_store_credit_total: "$0.00"covered_by_store_credit: false@@ -6828,8 +6983,8 @@ paths:metadata: {}canceled_at:approved_at:- created_at: '2026-05-17T22:58:06.570Z'- updated_at: '2026-05-17T22:58:06.651Z'+ created_at: '2026-05-21T18:11:28.197Z'+ updated_at: '2026-05-21T18:11:28.276Z'preferred_stock_location_id:tags: []internal_note:@@ -6910,8 +7065,8 @@ paths:id: or_UkLWZg9DAJmarket_id:channel_id: ch_UkLWZg9DAJ- number: R062143227- email: [email protected]+ number: R089309105+ email: [email protected]customer_note:currency: USDlocale: en@@ -6938,7 +7093,7 @@ paths:display_delivery_total: "$10.00"fulfillment_status: canceledpayment_status: void- completed_at: '2026-05-17T22:58:07.890Z'+ completed_at: '2026-05-21T18:11:29.520Z'store_credit_total: '0.0'display_store_credit_total: "$0.00"covered_by_store_credit: false@@ -6952,10 +7107,10 @@ paths:payment_total: '0.0'display_payment_total: "$0.00"metadata: {}- canceled_at: '2026-05-17T22:58:08.177Z'+ canceled_at: '2026-05-21T18:11:29.814Z'approved_at:- created_at: '2026-05-17T22:58:07.834Z'- updated_at: '2026-05-17T22:58:08.218Z'+ created_at: '2026-05-21T18:11:29.466Z'+ updated_at: '2026-05-21T18:11:29.851Z'preferred_stock_location_id:tags: []internal_note:@@ -7014,8 +7169,8 @@ paths:id: or_UkLWZg9DAJmarket_id:channel_id: ch_UkLWZg9DAJ- number: R328362970- email: [email protected]+ number: R821320090+ email: [email protected]customer_note:currency: USDlocale: en@@ -7042,7 +7197,7 @@ paths:display_delivery_total: "$100.00"fulfillment_status:payment_status:- completed_at: '2026-05-17T22:58:08.595Z'+ completed_at: '2026-05-21T18:11:30.205Z'store_credit_total: '0.0'display_store_credit_total: "$0.00"covered_by_store_credit: false@@ -7057,9 +7212,9 @@ paths:display_payment_total: "$0.00"metadata: {}canceled_at:- approved_at: '2026-05-17T22:58:08.896Z'- created_at: '2026-05-17T22:58:08.517Z'- updated_at: '2026-05-17T22:58:08.595Z'+ approved_at: '2026-05-21T18:11:30.500Z'+ created_at: '2026-05-21T18:11:30.151Z'+ updated_at: '2026-05-21T18:11:30.205Z'preferred_stock_location_id:tags: []internal_note:@@ -7118,8 +7273,8 @@ paths:id: or_UkLWZg9DAJmarket_id:channel_id: ch_UkLWZg9DAJ- number: R862448919- email: [email protected]+ number: R851503398+ email: [email protected]customer_note:currency: USDlocale: en@@ -7146,7 +7301,7 @@ paths:display_delivery_total: "$10.00"fulfillment_status: canceledpayment_status: void- completed_at: '2026-05-17T22:58:09.237Z'+ completed_at: '2026-05-21T18:11:30.837Z'store_credit_total: '0.0'display_store_credit_total: "$0.00"covered_by_store_credit: false@@ -7160,10 +7315,10 @@ paths:payment_total: '0.0'display_payment_total: "$0.00"metadata: {}- canceled_at: '2026-05-17T22:58:09.515Z'+ canceled_at: '2026-05-21T18:11:31.121Z'approved_at:- created_at: '2026-05-17T22:58:09.182Z'- updated_at: '2026-05-17T22:58:09.601Z'+ created_at: '2026-05-21T18:11:30.783Z'+ updated_at: '2026-05-21T18:11:31.205Z'preferred_stock_location_id:tags: []internal_note:@@ -7222,8 +7377,8 @@ paths:id: or_UkLWZg9DAJmarket_id:channel_id: ch_UkLWZg9DAJ- number: R636920706- email: [email protected]+ number: R035776695+ email: [email protected]customer_note:currency: USDlocale: en@@ -7250,7 +7405,7 @@ paths:display_delivery_total: "$100.00"fulfillment_status:payment_status:- completed_at: '2026-05-17T22:58:09.934Z'+ completed_at: '2026-05-21T18:11:31.546Z'store_credit_total: '0.0'display_store_credit_total: "$0.00"covered_by_store_credit: false@@ -7266,8 +7421,8 @@ paths:metadata: {}canceled_at:approved_at:- created_at: '2026-05-17T22:58:09.880Z'- updated_at: '2026-05-17T22:58:09.934Z'+ created_at: '2026-05-21T18:11:31.489Z'+ updated_at: '2026-05-21T18:11:31.546Z'preferred_stock_location_id:tags: []internal_note:@@ -7342,8 +7497,8 @@ paths:auto_capture:storefront_visible: trueposition: 1- created_at: '2026-05-17T22:58:10.232Z'- updated_at: '2026-05-17T22:58:10.233Z'+ created_at: '2026-05-21T18:11:31.844Z'+ updated_at: '2026-05-21T18:11:31.845Z'preferences: {}preference_schema: []meta:@@ -7483,8 +7638,8 @@ paths:auto_capture:storefront_visible: trueposition: 1- created_at: '2026-05-17T22:58:10.803Z'- updated_at: '2026-05-17T22:58:10.805Z'+ created_at: '2026-05-21T18:11:32.415Z'+ updated_at: '2026-05-21T18:11:32.417Z'preferences: {}preference_schema: []"/api/v3/admin/products/{product_id}/custom_fields":@@ -7554,8 +7709,8 @@ paths:field_type: short_textkey: custom.titlevalue: wool- created_at: '2026-05-17T22:58:11.118Z'- updated_at: '2026-05-17T22:58:11.118Z'+ created_at: '2026-05-21T18:11:32.732Z'+ updated_at: '2026-05-21T18:11:32.732Z'storefront_visible: truecustom_field_definition_id: cfdef_UkLWZg9DAJmeta:@@ -7622,8 +7777,8 @@ paths:field_type: long_textkey: custom.descriptionvalue: A longer description- created_at: '2026-05-17T22:58:11.733Z'- updated_at: '2026-05-17T22:58:11.733Z'+ created_at: '2026-05-21T18:11:33.356Z'+ updated_at: '2026-05-21T18:11:33.356Z'storefront_visible: truecustom_field_definition_id: cfdef_gbHJdmfrXB'422':@@ -7707,8 +7862,8 @@ paths:field_type: short_textkey: custom.titlevalue: wool- created_at: '2026-05-17T22:58:12.085Z'- updated_at: '2026-05-17T22:58:12.085Z'+ created_at: '2026-05-21T18:11:33.706Z'+ updated_at: '2026-05-21T18:11:33.706Z'storefront_visible: truecustom_field_definition_id: cfdef_UkLWZg9DAJpatch:@@ -7755,8 +7910,8 @@ paths:field_type: short_textkey: custom.titlevalue: cotton- created_at: '2026-05-17T22:58:12.401Z'- updated_at: '2026-05-17T22:58:12.680Z'+ created_at: '2026-05-21T18:11:34.022Z'+ updated_at: '2026-05-21T18:11:34.306Z'storefront_visible: truecustom_field_definition_id: cfdef_UkLWZg9DAJrequestBody:@@ -7894,33 +8049,33 @@ paths:example:data:- id: prod_UkLWZg9DAJ- name: Product 398974- slug: product-398974+ name: Product 393216+ slug: product-393216meta_title:meta_description:meta_keywords:variant_count: 0- available_on: '2025-05-17T22:58:13.003Z'+ available_on: '2025-05-21T18:11:34.653Z'purchasable: truein_stock: falsebackorderable: trueavailable: true- description: Officiis magnam distinctio voluptatibus dolores provident.- Quae neque corrupti natus id voluptatem occaecati. Eos commodi- deserunt quas voluptatibus occaecati ut minus impedit. Molestias- tempora quaerat fuga animi occaecati autem voluptatem. Ad error- reiciendis odit architecto asperiores quaerat laborum a. Quisquam- voluptas cupiditate saepe corporis. Rerum quibusdam odio recusandae- minima. Rerum reprehenderit magnam qui exercitationem. Debitis- ex optio rem facere officia maiores. Assumenda amet deserunt omnis- reiciendis repellendus. Facere cupiditate tempore vel itaque minus.- Possimus quisquam error atque recusandae vel. Pariatur repudiandae- nam consequuntur fuga voluptates blanditiis dolores beatae. Temporibus- vitae nam odio velit voluptatibus.+ description: Vero nulla quasi dignissimos maxime sequi ipsam voluptas+ eaque. Distinctio quibusdam sint accusantium consectetur. Suscipit+ nobis aliquid laudantium nihil. Asperiores modi laudantium culpa+ blanditiis sapiente ab architecto ut. Provident ipsa doloribus+ illo accusamus fugiat ullam magni voluptates. Aut laboriosam repellendus+ iusto omnis alias. Ipsam eius totam minima rerum molestiae. Aspernatur+ sequi voluptatum quia cum architecto sunt eveniet esse. Quibusdam+ consequatur totam in non neque. Nam quaerat molestias fugit neque+ nemo vitae veritatis saepe. Voluptatibus minima aspernatur pariatur+ doloribus repudiandae eaque. Doloremque quisquam eveniet repellendus+ aut eos quam blanditiis occaecati. Sequi iste asperiores distinctio+ harum. Voluptatibus optio asperiores voluptas labore non laboriosam.description_html: |-- Officiis magnam distinctio voluptatibus dolores provident. Quae neque corrupti natus id voluptatem occaecati. Eos commodi deserunt quas voluptatibus occaecati ut minus impedit. Molestias tempora quaerat fuga animi occaecati autem voluptatem.- Ad error reiciendis odit architecto asperiores quaerat laborum a. Quisquam voluptas cupiditate saepe corporis. Rerum quibusdam odio recusandae minima. Rerum reprehenderit magnam qui exercitationem. Debitis ex optio rem facere officia maiores.- Assumenda amet deserunt omnis reiciendis repellendus. Facere cupiditate tempore vel itaque minus. Possimus quisquam error atque recusandae vel. Pariatur repudiandae nam consequuntur fuga voluptates blanditiis dolores beatae. Temporibus vitae nam odio velit voluptatibus.+ Vero nulla quasi dignissimos maxime sequi ipsam voluptas eaque. Distinctio quibusdam sint accusantium consectetur. Suscipit nobis aliquid laudantium nihil. Asperiores modi laudantium culpa blanditiis sapiente ab architecto ut.+ Provident ipsa doloribus illo accusamus fugiat ullam magni voluptates. Aut laboriosam repellendus iusto omnis alias. Ipsam eius totam minima rerum molestiae. Aspernatur sequi voluptatum quia cum architecto sunt eveniet esse. Quibusdam consequatur totam in non neque.+ Nam quaerat molestias fugit neque nemo vitae veritatis saepe. Voluptatibus minima aspernatur pariatur doloribus repudiandae eaque. Doloremque quisquam eveniet repellendus aut eos quam blanditiis occaecati. Sequi iste asperiores distinctio harum. Voluptatibus optio asperiores voluptas labore non laboriosam.default_variant_id: variant_UkLWZg9DAJthumbnail_url:tags: []@@ -7935,16 +8090,16 @@ paths:display_compare_at_amount:price_list_id:variant_id: variant_UkLWZg9DAJ- created_at: '2026-05-17T22:58:13.027Z'- updated_at: '2026-05-17T22:58:13.027Z'+ created_at: '2026-05-21T18:11:34.688Z'+ updated_at: '2026-05-21T18:11:34.688Z'original_price:status: active- make_active_at: '2025-05-17T22:58:13.003Z'+ make_active_at: '2025-05-21T18:11:34.654Z'discontinue_on:metadata: {}deleted_at:- created_at: '2026-05-17T22:58:13.014Z'- updated_at: '2026-05-17T22:58:13.028Z'+ created_at: '2026-05-21T18:11:34.668Z'+ updated_at: '2026-05-21T18:11:34.690Z'tax_category_id: taxcat_UkLWZg9DAJmeta:page: 1@@ -8078,8 +8233,8 @@ paths:discontinue_on:metadata: {}deleted_at:- created_at: '2026-05-17T22:58:13.688Z'- updated_at: '2026-05-17T22:58:13.691Z'+ created_at: '2026-05-21T18:11:35.401Z'+ updated_at: '2026-05-21T18:11:35.404Z'tax_category_id:schema:"$ref": "#/components/schemas/Product"@@ -8259,25 +8414,32 @@ paths:application/json:example:id: prod_UkLWZg9DAJ- name: Product 438556- slug: product-438556+ name: Product 439727+ slug: product-439727meta_title:meta_description:meta_keywords:variant_count: 0- available_on: '2025-05-17T22:58:14.064Z'+ available_on: '2025-05-21T18:11:35.746Z'purchasable: truein_stock: falsebackorderable: trueavailable: true- description: Voluptatem magni libero quam officia earum esse inventore- assumenda. Dolores impedit aliquam eum voluptatem. Ducimus ullam- consequuntur nam perspiciatis deleniti aut. Vero necessitatibus- magnam et fugiat perspiciatis. Sunt eos repellendus odit incidunt.- description_html: Voluptatem magni libero quam officia earum esse- inventore assumenda. Dolores impedit aliquam eum voluptatem. Ducimus- ullam consequuntur nam perspiciatis deleniti aut. Vero necessitatibus- magnam et fugiat perspiciatis. Sunt eos repellendus odit incidunt.+ description: Eaque quos laborum maxime rem. Tenetur consequatur iste+ inventore quae. Nobis libero fuga animi dolorum ea eveniet deserunt.+ Repellendus autem placeat tempore nesciunt unde in suscipit eligendi.+ Occaecati minus exercitationem vel dignissimos. Veritatis blanditiis+ adipisci perspiciatis vero autem sapiente fugiat quos. Laboriosam+ provident omnis unde qui nam quasi corrupti quibusdam. Hic minus+ aliquam voluptates tempore culpa facere. Sed earum aperiam natus+ repellat blanditiis asperiores nobis animi. Illo veritatis autem+ quibusdam laudantium blanditiis alias. Dolorem quae laboriosam qui+ voluptate occaecati ab. Maiores deserunt fugit maxime temporibus+ cupiditate tempore distinctio minus.+ description_html: |-+ Eaque quos laborum maxime rem. Tenetur consequatur iste inventore quae. Nobis libero fuga animi dolorum ea eveniet deserunt. Repellendus autem placeat tempore nesciunt unde in suscipit eligendi.+ Occaecati minus exercitationem vel dignissimos. Veritatis blanditiis adipisci perspiciatis vero autem sapiente fugiat quos. Laboriosam provident omnis unde qui nam quasi corrupti quibusdam. Hic minus aliquam voluptates tempore culpa facere.+ Sed earum aperiam natus repellat blanditiis asperiores nobis animi. Illo veritatis autem quibusdam laudantium blanditiis alias. Dolorem quae laboriosam qui voluptate occaecati ab. Maiores deserunt fugit maxime temporibus cupiditate tempore distinctio minus.default_variant_id: variant_UkLWZg9DAJthumbnail_url:tags: []@@ -8292,16 +8454,16 @@ paths:display_compare_at_amount:price_list_id:variant_id: variant_UkLWZg9DAJ- created_at: '2026-05-17T22:58:14.092Z'- updated_at: '2026-05-17T22:58:14.092Z'+ created_at: '2026-05-21T18:11:35.771Z'+ updated_at: '2026-05-21T18:11:35.771Z'original_price:status: active- make_active_at: '2025-05-17T22:58:14.064Z'+ make_active_at: '2025-05-21T18:11:35.746Z'discontinue_on:metadata: {}deleted_at:- created_at: '2026-05-17T22:58:14.078Z'- updated_at: '2026-05-17T22:58:14.093Z'+ created_at: '2026-05-21T18:11:35.758Z'+ updated_at: '2026-05-21T18:11:35.772Z'tax_category_id: taxcat_UkLWZg9DAJschema:"$ref": "#/components/schemas/Product"@@ -8368,29 +8530,27 @@ paths:example:id: prod_UkLWZg9DAJname: Updated Name- slug: product-452799+ slug: product-451000meta_title:meta_description:meta_keywords:variant_count: 0- available_on: '2025-05-17T22:58:14.706Z'+ available_on: '2025-05-21T18:11:36.403Z'purchasable: truein_stock: falsebackorderable: trueavailable: true- description: Facilis error earum consequuntur in. Ut sint dolor exercitationem- cupiditate tenetur cum. Eos earum accusantium repellendus fugiat- eum non. Explicabo molestiae eligendi eaque aperiam. Quaerat enim- unde impedit expedita iure omnis vel. Ut dicta autem omnis quas- ipsam unde. Delectus quo ad nihil dignissimos. Dicta tenetur eius- provident veritatis ut error quia ullam. Labore neque atque ipsam- qui voluptatum eligendi. Id laborum magni est deserunt natus consequuntur.- Quibusdam ab modi officia tempore facilis omnis. Et nemo consequatur- dolorum labore.+ description: Sequi in quas magni odio excepturi. Libero nostrum eius+ ipsa eos molestias officiis aut officia. Dignissimos ex distinctio+ velit ut molestiae ipsa animi. Minus architecto tempora error totam+ autem rerum soluta laboriosam. Assumenda alias temporibus dolorem+ laboriosam necessitatibus culpa eaque natus. Officia voluptate dolore+ occaecati molestias tenetur neque quia. Magni sit nisi sapiente+ ipsa ea similique. Repudiandae facilis veritatis sunt vitae consectetur+ tempora possimus fugiat.description_html: |-- Facilis error earum consequuntur in. Ut sint dolor exercitationem cupiditate tenetur cum. Eos earum accusantium repellendus fugiat eum non. Explicabo molestiae eligendi eaque aperiam.- Quaerat enim unde impedit expedita iure omnis vel. Ut dicta autem omnis quas ipsam unde. Delectus quo ad nihil dignissimos. Dicta tenetur eius provident veritatis ut error quia ullam. Labore neque atque ipsam qui voluptatum eligendi.- Id laborum magni est deserunt natus consequuntur. Quibusdam ab modi officia tempore facilis omnis. Et nemo consequatur dolorum labore.+ Sequi in quas magni odio excepturi. Libero nostrum eius ipsa eos molestias officiis aut officia. Dignissimos ex distinctio velit ut molestiae ipsa animi. Minus architecto tempora error totam autem rerum soluta laboriosam.+ Assumenda alias temporibus dolorem laboriosam necessitatibus culpa eaque natus. Officia voluptate dolore occaecati molestias tenetur neque quia. Magni sit nisi sapiente ipsa ea similique. Repudiandae facilis veritatis sunt vitae consectetur tempora possimus fugiat.default_variant_id: variant_UkLWZg9DAJthumbnail_url:tags: []@@ -8405,16 +8565,16 @@ paths:display_compare_at_amount:price_list_id:variant_id: variant_UkLWZg9DAJ- created_at: '2026-05-17T22:58:14.732Z'- updated_at: '2026-05-17T22:58:14.732Z'+ created_at: '2026-05-21T18:11:36.428Z'+ updated_at: '2026-05-21T18:11:36.428Z'original_price:status: active- make_active_at: '2025-05-17T22:58:14.706Z'+ make_active_at: '2025-05-21T18:11:36.403Z'discontinue_on:metadata: {}deleted_at:- created_at: '2026-05-17T22:58:14.720Z'- updated_at: '2026-05-17T22:58:15.016Z'+ created_at: '2026-05-21T18:11:36.416Z'+ updated_at: '2026-05-21T18:11:36.715Z'tax_category_id: taxcat_UkLWZg9DAJschema:"$ref": "#/components/schemas/Product"@@ -8617,8 +8777,8 @@ paths:example:data:- id: pact_UkLWZg9DAJ- created_at: '2026-05-17T22:58:15.703Z'- updated_at: '2026-05-17T22:58:15.703Z'+ created_at: '2026-05-21T18:11:37.379Z'+ updated_at: '2026-05-21T18:11:37.379Z'type: free_shippingpromotion_id: promo_UkLWZg9DAJpreferences: {}@@ -8679,8 +8839,8 @@ paths:application/json:example:id: pact_UkLWZg9DAJ- created_at: '2026-05-17T22:58:16.273Z'- updated_at: '2026-05-17T22:58:16.273Z'+ created_at: '2026-05-21T18:11:37.945Z'+ updated_at: '2026-05-21T18:11:37.945Z'type: free_shippingpromotion_id: promo_UkLWZg9DAJpreferences: {}@@ -8790,8 +8950,8 @@ paths:example:data:- id: prorule_UkLWZg9DAJ- created_at: '2026-05-17T22:58:16.871Z'- updated_at: '2026-05-17T22:58:16.871Z'+ created_at: '2026-05-21T18:11:38.523Z'+ updated_at: '2026-05-21T18:11:38.523Z'type: currencypromotion_id: promo_UkLWZg9DAJpreferences:@@ -8858,8 +9018,8 @@ paths:application/json:example:id: prorule_UkLWZg9DAJ- created_at: '2026-05-17T22:58:17.455Z'- updated_at: '2026-05-17T22:58:17.455Z'+ created_at: '2026-05-21T18:11:39.091Z'+ updated_at: '2026-05-21T18:11:39.091Z'type: currencypromotion_id: promo_UkLWZg9DAJpreferences:@@ -8932,8 +9092,8 @@ paths:application/json:example:id: prorule_UkLWZg9DAJ- created_at: '2026-05-17T22:58:17.744Z'- updated_at: '2026-05-17T22:58:18.021Z'+ created_at: '2026-05-21T18:11:39.384Z'+ updated_at: '2026-05-21T18:11:39.664Z'type: currencypromotion_id: promo_UkLWZg9DAJpreferences:@@ -9023,7 +9183,7 @@ paths:name: Summer Saledescription:code: summer- starts_at: '2026-05-17T22:58:18.315Z'+ starts_at: '2026-05-21T18:11:39.958Z'expires_at:usage_limit:match_policy: all@@ -9034,8 +9194,8 @@ paths:code_prefix:promotion_category_id:metadata: {}- created_at: '2026-05-17T22:58:18.316Z'- updated_at: '2026-05-17T22:58:18.317Z'+ created_at: '2026-05-21T18:11:39.959Z'+ updated_at: '2026-05-21T18:11:39.960Z'store_ids:- store_UkLWZg9DAJaction_ids: []@@ -9141,7 +9301,7 @@ paths:name: Black Fridaydescription:code: blackfriday-os- starts_at: '2026-05-17T22:58:19.244Z'+ starts_at: '2026-05-21T18:11:40.878Z'expires_at:usage_limit:match_policy: all@@ -9152,8 +9312,8 @@ paths:code_prefix:promotion_category_id:metadata: {}- created_at: '2026-05-17T22:58:19.245Z'- updated_at: '2026-05-17T22:58:19.266Z'+ created_at: '2026-05-21T18:11:40.879Z'+ updated_at: '2026-05-21T18:11:40.900Z'store_ids:- store_UkLWZg9DAJaction_ids:@@ -9306,7 +9466,7 @@ paths:name: Summer Saledescription:code: summer- starts_at: '2026-05-17T22:58:19.562Z'+ starts_at: '2026-05-21T18:11:41.191Z'expires_at:usage_limit:match_policy: all@@ -9317,8 +9477,8 @@ paths:code_prefix:promotion_category_id:metadata: {}- created_at: '2026-05-17T22:58:19.563Z'- updated_at: '2026-05-17T22:58:19.564Z'+ created_at: '2026-05-21T18:11:41.191Z'+ updated_at: '2026-05-21T18:11:41.192Z'store_ids:- store_UkLWZg9DAJaction_ids: []@@ -9414,7 +9574,7 @@ paths:name: Summer Saledescription:code: summer- starts_at: '2026-05-17T22:58:20.443Z'+ starts_at: '2026-05-21T18:11:42.115Z'expires_at:usage_limit:match_policy: all@@ -9425,8 +9585,8 @@ paths:code_prefix:promotion_category_id:metadata: {}- created_at: '2026-05-17T22:58:20.443Z'- updated_at: '2026-05-17T22:58:20.736Z'+ created_at: '2026-05-21T18:11:42.115Z'+ updated_at: '2026-05-21T18:11:42.394Z'store_ids:- store_UkLWZg9DAJaction_ids: []@@ -9778,8 +9938,8 @@ paths:data:- id: role_UkLWZg9DAJname: admin- created_at: '2026-05-17T22:58:21.622Z'- updated_at: '2026-05-17T22:58:21.622Z'+ created_at: '2026-05-21T18:11:43.260Z'+ updated_at: '2026-05-21T18:11:43.260Z'meta:page: 1limit: 25@@ -9914,8 +10074,8 @@ paths:pickup_stock_policy: localpickup_ready_in_minutes:pickup_instructions:- created_at: '2026-05-17T22:58:21.908Z'- updated_at: '2026-05-17T22:58:21.908Z'+ created_at: '2026-05-21T18:11:43.547Z'+ updated_at: '2026-05-21T18:11:43.547Z'meta:page: 1limit: 25@@ -10026,8 +10186,8 @@ paths:pickup_stock_policy: localpickup_ready_in_minutes: 30pickup_instructions:- created_at: '2026-05-17T22:58:22.489Z'- updated_at: '2026-05-17T22:58:22.489Z'+ created_at: '2026-05-21T18:11:44.126Z'+ updated_at: '2026-05-21T18:11:44.126Z'schema:"$ref": "#/components/schemas/StockLocation"'422':@@ -10201,8 +10361,8 @@ paths:pickup_stock_policy: localpickup_ready_in_minutes:pickup_instructions:- created_at: '2026-05-17T22:58:22.779Z'- updated_at: '2026-05-17T22:58:22.779Z'+ created_at: '2026-05-21T18:11:44.416Z'+ updated_at: '2026-05-21T18:11:44.416Z'schema:"$ref": "#/components/schemas/StockLocation"'404':@@ -10287,8 +10447,8 @@ paths:pickup_stock_policy: localpickup_ready_in_minutes: 45pickup_instructions:- created_at: '2026-05-17T22:58:23.346Z'- updated_at: '2026-05-17T22:58:23.623Z'+ created_at: '2026-05-21T18:11:44.981Z'+ updated_at: '2026-05-21T18:11:45.255Z'schema:"$ref": "#/components/schemas/StockLocation"'422':@@ -10491,8 +10651,8 @@ paths:data:- id: sccat_UkLWZg9DAJname: Goodwill- created_at: '2026-05-17T22:58:24.197Z'- updated_at: '2026-05-17T22:58:24.197Z'+ created_at: '2026-05-21T18:11:45.829Z'+ updated_at: '2026-05-21T18:11:45.829Z'non_expiring: falsemeta:page: 1@@ -10583,8 +10743,8 @@ paths:example:id: sccat_UkLWZg9DAJname: Goodwill- created_at: '2026-05-17T22:58:24.493Z'- updated_at: '2026-05-17T22:58:24.493Z'+ created_at: '2026-05-21T18:11:46.128Z'+ updated_at: '2026-05-21T18:11:46.128Z'non_expiring: falseschema:"$ref": "#/components/schemas/StoreCreditCategory"@@ -10649,8 +10809,8 @@ paths:preferred_timezone: UTCpreferred_weight_unit: lbpreferred_unit_system: imperial- created_at: '2026-05-17T22:57:20.918Z'- updated_at: '2026-05-17T22:58:25.097Z'+ created_at: '2026-05-21T18:10:40.892Z'+ updated_at: '2026-05-21T18:11:46.714Z'url: http://www.example.com:3000supported_currencies:- USD@@ -10721,8 +10881,8 @@ paths:preferred_timezone: UTCpreferred_weight_unit: lbpreferred_unit_system: imperial- created_at: '2026-05-17T22:57:20.918Z'- updated_at: '2026-05-17T22:58:25.709Z'+ created_at: '2026-05-21T18:10:40.892Z'+ updated_at: '2026-05-21T18:11:47.343Z'url: http://www.example.com:3000supported_currencies:- USD@@ -10942,13 +11102,13 @@ paths:weight_unit: lbdimensions_unit:deleted_at:- created_at: '2026-05-17T22:58:27.121Z'- updated_at: '2026-05-17T22:58:27.134Z'+ created_at: '2026-05-21T18:11:48.762Z'+ updated_at: '2026-05-21T18:11:48.775Z'tax_category_id: taxcat_UkLWZg9DAJavailable_stock: 0reserved_quantity: 0total_on_hand: 0- product_name: Product 509759+ product_name: Product 50221- id: variant_gbHJdmfrXBproduct_id: prod_UkLWZg9DAJsku: SKU-57@@ -10959,10 +11119,10 @@ paths:purchasable: truein_stock: falsebackorderable: true- weight: 80.73- height: 2.44- width: 113.51- depth: 190.29+ weight: 135.61+ height: 190.22+ width: 43.51+ depth: 109.66price:id: price_gbHJdmfrXBamount: '19.99'@@ -10985,8 +11145,8 @@ paths:option_type_label: Sizeimage_url:metadata: {}- created_at: '2026-05-17T22:58:27.144Z'- updated_at: '2026-05-17T22:58:27.144Z'+ created_at: '2026-05-21T18:11:48.786Z'+ updated_at: '2026-05-21T18:11:48.786Z'metadata: {}position: 2cost_price: '17.0'@@ -10995,13 +11155,13 @@ paths:weight_unit: lbdimensions_unit:deleted_at:- created_at: '2026-05-17T22:58:27.141Z'- updated_at: '2026-05-17T22:58:27.155Z'+ created_at: '2026-05-21T18:11:48.783Z'+ updated_at: '2026-05-21T18:11:48.798Z'tax_category_id: taxcat_UkLWZg9DAJavailable_stock: 0reserved_quantity: 0total_on_hand: 0- product_name: Product 509759+ product_name: Product 50221meta:page: 1limit: 25@@ -11112,8 +11272,8 @@ paths:option_type_label: Sizeimage_url:metadata: {}- created_at: '2026-05-17T22:58:27.805Z'- updated_at: '2026-05-17T22:58:27.805Z'+ created_at: '2026-05-21T18:11:49.443Z'+ updated_at: '2026-05-21T18:11:49.443Z'metadata: {}position: 3cost_price:@@ -11122,13 +11282,13 @@ paths:weight_unit: lbdimensions_unit:deleted_at:- created_at: '2026-05-17T22:58:27.808Z'- updated_at: '2026-05-17T22:58:27.810Z'+ created_at: '2026-05-21T18:11:49.446Z'+ updated_at: '2026-05-21T18:11:49.447Z'tax_category_id: taxcat_UkLWZg9DAJavailable_stock: 0reserved_quantity: 0total_on_hand: 0- product_name: Product 512942+ product_name: Product 512416'422':description: validation errorcontent:@@ -11315,10 +11475,10 @@ paths:purchasable: truein_stock: falsebackorderable: true- weight: 110.63- height: 3.38- width: 79.16- depth: 28.31+ weight: 21.18+ height: 160.0+ width: 127.7+ depth: 17.83price:id: price_gbHJdmfrXBamount: '19.99'@@ -11341,8 +11501,8 @@ paths:option_type_label: Sizeimage_url:metadata: {}- created_at: '2026-05-17T22:58:28.233Z'- updated_at: '2026-05-17T22:58:28.233Z'+ created_at: '2026-05-21T18:11:49.893Z'+ updated_at: '2026-05-21T18:11:49.893Z'metadata: {}position: 2cost_price: '17.0'@@ -11351,13 +11511,13 @@ paths:weight_unit: lbdimensions_unit:deleted_at:- created_at: '2026-05-17T22:58:28.231Z'- updated_at: '2026-05-17T22:58:28.246Z'+ created_at: '2026-05-21T18:11:49.887Z'+ updated_at: '2026-05-21T18:11:49.910Z'tax_category_id: taxcat_UkLWZg9DAJavailable_stock: 0reserved_quantity: 0total_on_hand: 0- product_name: Product 535621+ product_name: Product 537070'404':description: variant not foundcontent:@@ -11436,10 +11596,10 @@ paths:purchasable: truein_stock: falsebackorderable: true- weight: 24.88- height: 167.5- width: 121.98- depth: 156.64+ weight: 103.11+ height: 18.21+ width: 34.43+ depth: 192.11price:id: price_gbHJdmfrXBamount: '19.99'@@ -11462,8 +11622,8 @@ paths:option_type_label: Sizeimage_url:metadata: {}- created_at: '2026-05-17T22:58:28.920Z'- updated_at: '2026-05-17T22:58:28.920Z'+ created_at: '2026-05-21T18:11:50.606Z'+ updated_at: '2026-05-21T18:11:50.606Z'metadata: {}position: 2cost_price: '17.0'@@ -11472,13 +11632,13 @@ paths:weight_unit: lbdimensions_unit:deleted_at:- created_at: '2026-05-17T22:58:28.917Z'- updated_at: '2026-05-17T22:58:29.223Z'+ created_at: '2026-05-21T18:11:50.603Z'+ updated_at: '2026-05-21T18:11:50.909Z'tax_category_id: taxcat_UkLWZg9DAJavailable_stock: 0reserved_quantity: 0total_on_hand: 0- product_name: Product 552946+ product_name: Product 555738requestBody:content:application/json:@@ -12581,6 +12741,10 @@ components:type: arrayitems:"$ref": "#/components/schemas/StoreCredit"+ customer_groups:+ type: array+ items:+ "$ref": "#/components/schemas/CustomerGroup"required:- iddiff --git a/docs/api-reference/store.yaml b/docs/api-reference/store.yamlindex 97784f57b2..96d3a88f93 100644--- a/docs/api-reference/store.yaml+++ b/docs/api-reference/store.yaml@@ -590,16 +590,16 @@ paths:content:application/json:example:- token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJjdXN0b21lciIsImp0aSI6IjQxNmNkZmZkLTFjNjMtNDVlZS1hZmZmLWZhMDIyNjg4ZTRmYiIsImlzcyI6InNwcmVlIiwiYXVkIjoic3RvcmVfYXBpIiwiZXhwIjoxNzc5Mzc1NjU4fQ.di9q1SWMr4u6iu85LphhF1wm14rfo7TSMV_mL-w2x_c- refresh_token: BzLiMBEy42daj8QzPgfdN7VR+ token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJjdXN0b21lciIsImp0aSI6ImFjMTYxZjIyLTY2ODUtNDM0My1hZjhlLWFmNmZiY2Q4NzA3ZCIsImlzcyI6InNwcmVlIiwiYXVkIjoic3RvcmVfYXBpIiwiZXhwIjoxNzc5MzkwNzE2fQ.BuOWlcghPrLfW7-ka3a2yD1Giq5DAG-5amAPCOsJOvY+ refresh_token: PZZGJT4udwGkyKEPgs4WRtususer:id: cus_UkLWZg9DAJemail: [email protected]- first_name: Muriel- last_name: Rolfson+ first_name: Henriette+ last_name: Stammphone:accepts_email_marketing: false- full_name: Muriel Rolfson+ full_name: Henriette Stammavailable_store_credit_total: '0'display_available_store_credit_total: "$0.00"addresses: []@@ -672,16 +672,16 @@ paths:content:application/json:example:- token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJjdXN0b21lciIsImp0aSI6ImY1ZTI0OWZjLTU2OWItNGMxOS05NmY0LTczMGQ0MTkyNDllYSIsImlzcyI6InNwcmVlIiwiYXVkIjoic3RvcmVfYXBpIiwiZXhwIjoxNzc5Mzc1NjU5fQ.Mj5GatT53qoIVQWM5C6SGLMjC_8W-tbfBAYiwuqxssw- refresh_token: ATUxJ8cznsCRdeM94bt6MpFb+ token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJjdXN0b21lciIsImp0aSI6Ijg2NTFkMTJlLTRiMTItNDZhNi1hYjgzLTY4MjI1YWNhN2FhYyIsImlzcyI6InNwcmVlIiwiYXVkIjoic3RvcmVfYXBpIiwiZXhwIjoxNzc5MzkwNzE3fQ.mz2V3U-_6wrTzoLytYOOGc7mgH7eG71jQ_oA4mIHGtY+ refresh_token: sRppucnbaakQTvpFCoJArcdeuser:id: cus_UkLWZg9DAJemail: [email protected]- first_name: Yoshiko- last_name: Gerlach+ first_name: Richard+ last_name: Larsonphone:accepts_email_marketing: false- full_name: Yoshiko Gerlach+ full_name: Richard Larsonavailable_store_credit_total: '0'display_available_store_credit_total: "$0.00"addresses: []@@ -845,9 +845,9 @@ paths:data:- id: cart_gbHJdmfrXBmarket_id:- number: R664489317- token: DNbsRBmEum7pEjvQP1kQfL82Sa9dpamPvNH- email: [email protected]+ number: R560405209+ token: iqxaKurjyPCbwiuDRJwhMTLpUQs2SCohKfM+ email: [email protected]customer_note:currency: USDlocale: en@@ -889,8 +889,8 @@ paths:variant_id: variant_gbHJdmfrXBquantity: 1currency: USD- name: Product 583769- slug: product-583769+ name: Product 584574+ slug: product-584574options_text: ''price: '10.0'display_price: "$10.00"@@ -915,7 +915,7 @@ paths:digital_links: []fulfillments:- id: ful_gbHJdmfrXB- number: H67163565781+ number: H60885401848tracking: U10000tracking_url:cost: '100.0'@@ -944,7 +944,7 @@ paths:stock_location:id: sloc_UkLWZg9DAJstate_abbr: NY- name: Ilona Raynor+ name: Milissa Kutchaddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'@@ -1014,9 +1014,9 @@ paths:market:- id: cart_UkLWZg9DAJmarket_id:- number: R608295263- token: hPKQmwQsRPWzchLyF6W66k6tmz7FDgywVra- email: [email protected]+ number: R504946559+ token: hC1f3UJxu4NErrgku3ZwU2LT4szVo2mJGUv+ email: [email protected]customer_note:currency: USDlocale: en@@ -1058,8 +1058,8 @@ paths:variant_id: variant_UkLWZg9DAJquantity: 1currency: USD- name: Product 571600- slug: product-571600+ name: Product 576038+ slug: product-576038options_text: ''price: '10.0'display_price: "$10.00"@@ -1084,7 +1084,7 @@ paths:digital_links: []fulfillments:- id: ful_UkLWZg9DAJ- number: H06444123777+ number: H14566689291tracking: U10000tracking_url:cost: '100.0'@@ -1113,7 +1113,7 @@ paths:stock_location:id: sloc_UkLWZg9DAJstate_abbr: NY- name: Ilona Raynor+ name: Milissa Kutchaddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'@@ -1256,8 +1256,8 @@ paths:example:id: cart_UkLWZg9DAJmarket_id:- number: R614354862- token: GFVVFvrWYoqA1u1YH7pVUxznA9FVYYYN16i+ number: R582709141+ token: sbMgF8VrnBNczXfdVscfNEDYvzNFowJwh2semail:customer_note:currency: USD@@ -1412,9 +1412,9 @@ paths:example:id: cart_UkLWZg9DAJmarket_id:- number: R391007411- token: TJQaoQquys2FEa6bQAQG6UNsTbugSQWxvu9- email: [email protected]+ number: R911594733+ token: A3bGmry4ZwaVKavBsi7VH9dHvdws3WTttaD+ email: [email protected]customer_note:currency: USDlocale: en@@ -1441,7 +1441,7 @@ paths:display_delivery_total: "$0.00"warnings:- code: line_item_removed- message: Product 623222 was removed because it was sold out+ message: Product 62216 was removed because it was sold outline_item_id: li_UkLWZg9DAJvariant_id: variant_UkLWZg9DAJstore_credit_total: '0.0'@@ -1583,9 +1583,9 @@ paths:example:id: cart_UkLWZg9DAJmarket_id:- number: R819048584- token: 2fF1kfwXemRtwo39BV6ZNNQHG29ThFThfx7- email: [email protected]+ number: R537545049+ token: YAfcmRTUDf8ak8FPefKTgpqKXuur3RZrz5S+ email: [email protected]customer_note: Leave at doorcurrency: USDlocale: en@@ -1629,8 +1629,8 @@ paths:variant_id: variant_UkLWZg9DAJquantity: 1currency: USD- name: Product 639240- slug: product-639240+ name: Product 637993+ slug: product-637993options_text: ''price: '19.99'display_price: "$19.99"@@ -1655,7 +1655,7 @@ paths:digital_links: []fulfillments:- id: ful_gbHJdmfrXB- number: H40312398138+ number: H35255737216tracking:tracking_url:cost: '10.0'@@ -1684,7 +1684,7 @@ paths:stock_location:id: sloc_UkLWZg9DAJstate_abbr: NY- name: Adella Kris+ name: Chung O'Keefeaddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'@@ -1921,9 +1921,9 @@ paths:example:id: cart_UkLWZg9DAJmarket_id:- number: R632083010- token: Hud7FDknGoibTteuPcBENinKizai8DriaWj- email: [email protected]+ number: R231347948+ token: RnHB5VgA21xi2SsJFvCKad7qbWLdo47QGnV+ email: [email protected]customer_note:currency: USDlocale: en@@ -1965,8 +1965,8 @@ paths:variant_id: variant_UkLWZg9DAJquantity: 1currency: USD- name: Product 659069- slug: product-659069+ name: Product 653132+ slug: product-653132options_text: ''price: '10.0'display_price: "$10.00"@@ -1991,7 +1991,7 @@ paths:digital_links: []fulfillments:- id: ful_UkLWZg9DAJ- number: H50751149271+ number: H45239248483tracking: U10000tracking_url:cost: '100.0'@@ -2020,7 +2020,7 @@ paths:stock_location:id: sloc_UkLWZg9DAJstate_abbr: NY- name: Aurelia McGlynn+ name: Dexter Boyeraddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'@@ -2155,8 +2155,8 @@ paths:id: or_UkLWZg9DAJmarket_id:channel_id: ch_UkLWZg9DAJ- number: R775225129- email: [email protected]+ number: R264397359+ email: [email protected]customer_note:currency: USDlocale: en@@ -2183,7 +2183,7 @@ paths:display_delivery_total: "$10.00"fulfillment_status: backorderpayment_status: paid- completed_at: '2026-05-21T14:01:05.267Z'+ completed_at: '2026-05-21T18:12:04.119Z'store_credit_total: '0.0'display_store_credit_total: "$0.00"covered_by_store_credit: false@@ -2193,8 +2193,8 @@ paths:variant_id: variant_UkLWZg9DAJquantity: 1currency: USD- name: Product 677597- slug: product-677597+ name: Product 679791+ slug: product-679791options_text: ''price: '19.99'display_price: "$19.99"@@ -2219,7 +2219,7 @@ paths:digital_links: []fulfillments:- id: ful_gbHJdmfrXB- number: H07213205217+ number: H72789993064tracking:tracking_url:cost: '10.0'@@ -2248,7 +2248,7 @@ paths:stock_location:id: sloc_UkLWZg9DAJstate_abbr: NY- name: Phylis Kozey+ name: Gabriela Kemmeraddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'@@ -2277,8 +2277,8 @@ paths:payments:- id: py_UkLWZg9DAJpayment_method_id: pm_UkLWZg9DAJ- response_code: BGS-d9218ca0c082- number: P6TGTMWL+ response_code: BGS-6d4860421892+ number: PDDA4ACIamount: '29.99'display_amount: "$29.99"status: completed@@ -3134,16 +3134,16 @@ paths:content:application/json:example:- token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJjdXN0b21lciIsImp0aSI6Ijk2ZTc1YzViLTY4NjMtNDkzMy1iYWFhLTZmNDZhNzFiY2VhZSIsImlzcyI6InNwcmVlIiwiYXVkIjoic3RvcmVfYXBpIiwiZXhwIjoxNzc5Mzc1NjcxfQ.TGikt0JLnGCtiRl8AWD75GYMbSA_VFk8R8tkkcVmo4M- refresh_token: rUy5d5FkkFKRKVTjSNLMmGXC+ token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJjdXN0b21lciIsImp0aSI6ImRhYjViODFiLWZkODQtNDU1NC1iZjJkLWFlYWUzZWJjYWEyZiIsImlzcyI6InNwcmVlIiwiYXVkIjoic3RvcmVfYXBpIiwiZXhwIjoxNzc5MzkwNzMwfQ.A7ZqLfCc-PN69iuQHuMdSM6U_leCsrC5gV5ABpuwtbc+ refresh_token: S8rzSN7cnzSAwzjbRFiTKHL8user:id: cus_UkLWZg9DAJemail: [email protected]- first_name: Iris- last_name: Hirthe+ first_name: Denita+ last_name: Rauphone:accepts_email_marketing: false- full_name: Iris Hirthe+ full_name: Denita Rauavailable_store_credit_total: '0'display_available_store_credit_total: "$0.00"addresses: []@@ -3316,8 +3316,8 @@ paths:- id: or_UkLWZg9DAJmarket_id:channel_id: ch_UkLWZg9DAJ- number: R453573119- email: [email protected]+ number: R600105954+ email: [email protected]customer_note:currency: USDlocale: en@@ -3344,7 +3344,7 @@ paths:display_delivery_total: "$100.00"fulfillment_status:payment_status:- completed_at: '2026-05-21T14:01:12.513Z'+ completed_at: '2026-05-21T18:12:11.464Z'store_credit_total: '0.0'display_store_credit_total: "$0.00"covered_by_store_credit: false@@ -3354,8 +3354,8 @@ paths:variant_id: variant_UkLWZg9DAJquantity: 1currency: USD- name: Product 763572- slug: product-763572+ name: Product 767917+ slug: product-767917options_text: ''price: '10.0'display_price: "$10.00"@@ -3380,7 +3380,7 @@ paths:digital_links: []fulfillments:- id: ful_UkLWZg9DAJ- number: H92480409501+ number: H90711662288tracking: U10000tracking_url:cost: '100.0'@@ -3409,7 +3409,7 @@ paths:stock_location:id: sloc_UkLWZg9DAJstate_abbr: NY- name: Aleen Powlowski+ name: Annie Marksaddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'@@ -3572,8 +3572,8 @@ paths:id: or_UkLWZg9DAJmarket_id:channel_id: ch_UkLWZg9DAJ- number: R788321337- email: [email protected]+ number: R060306455+ email: [email protected]customer_note:currency: USDlocale: en@@ -3600,7 +3600,7 @@ paths:display_delivery_total: "$100.00"fulfillment_status:payment_status:- completed_at: '2026-05-21T14:01:13.194Z'+ completed_at: '2026-05-21T18:12:12.168Z'store_credit_total: '0.0'display_store_credit_total: "$0.00"covered_by_store_credit: false@@ -3610,8 +3610,8 @@ paths:variant_id: variant_UkLWZg9DAJquantity: 1currency: USD- name: Product 78558- slug: product-78558+ name: Product 787709+ slug: product-787709options_text: ''price: '10.0'display_price: "$10.00"@@ -3636,7 +3636,7 @@ paths:digital_links: []fulfillments:- id: ful_UkLWZg9DAJ- number: H85969598405+ number: H26048702619tracking: U10000tracking_url:cost: '100.0'@@ -3665,7 +3665,7 @@ paths:stock_location:id: sloc_UkLWZg9DAJstate_abbr: NY- name: Ruthe Davis+ name: Nyla Rauaddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'@@ -3785,8 +3785,8 @@ paths:content:application/json:example:- token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJjdXN0b21lciIsImp0aSI6Ijg4ZWUyNGZiLTI2YjgtNDQxZi1hM2IwLTQ0ZDE1NWMxZDljNyIsImlzcyI6InNwcmVlIiwiYXVkIjoic3RvcmVfYXBpIiwiZXhwIjoxNzc5Mzc1Njc0fQ.H0u-Q3oSCKP2k0LaX7rQVF_U8c1IUvaRnwvBrzw8kGk- refresh_token: Zm5W1wfivD9a8J1WsaKiBAyc+ token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJjdXN0b21lciIsImp0aSI6ImVkNGE2MDhlLTdmNmUtNDc5NS1iNDc0LWU0MGQ2NGY1NjM0NCIsImlzcyI6InNwcmVlIiwiYXVkIjoic3RvcmVfYXBpIiwiZXhwIjoxNzc5MzkwNzMzfQ.zdjx-98AkEn-FCaKaIeYCOa0VzQacbTGsoD8RtSVrIc+ refresh_token: JmzdDVvP1CZnWvpsNvAwkEosuser:id: cus_UkLWZg9DAJemail: [email protected]@@ -3900,12 +3900,12 @@ paths:application/json:example:id: cus_UkLWZg9DAJ- email: [email protected]- first_name: Jacinta- last_name: Lang+ email: [email protected]+ first_name: Zackary+ last_name: Lindphone: 555-555-0199accepts_email_marketing: false- full_name: Jacinta Lang+ full_name: Zackary Lindavailable_store_credit_total: '0'display_available_store_credit_total: "$0.00"addresses:@@ -4039,7 +4039,7 @@ paths:application/json:example:id: cus_UkLWZg9DAJ- email: [email protected]+ email: [email protected]first_name: Updatedlast_name: Namephone: 555-555-0199@@ -4279,9 +4279,9 @@ paths:example:id: cart_UkLWZg9DAJmarket_id:- number: R877670295- token: jgYbDf4iuvRHVAFiJSJPC67pctiy9JX6pm3- email: [email protected]+ number: R983640452+ token: FUsN4w2fk57RAyQxK2uwVh1EFUSeoApoNWz+ email: [email protected]customer_note:currency: USDlocale: en@@ -4330,8 +4330,8 @@ paths:variant_id: variant_UkLWZg9DAJquantity: 1currency: USD- name: Product 866689- slug: product-866689+ name: Product 868984+ slug: product-868984options_text: ''price: '10.0'display_price: "$10.00"@@ -4356,7 +4356,7 @@ paths:digital_links: []fulfillments:- id: ful_UkLWZg9DAJ- number: H97941431341+ number: H01257048332tracking: U10000tracking_url:cost: '100.0'@@ -4385,7 +4385,7 @@ paths:stock_location:id: sloc_UkLWZg9DAJstate_abbr: NY- name: Delora Kerluke+ name: Idell Corkeryaddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'@@ -4539,9 +4539,9 @@ paths:example:id: cart_UkLWZg9DAJmarket_id:- number: R645855426- token: xKbwRLgMS3z13qkQ8U9pN6NYL6ofcQ9GHZ7- email: [email protected]+ number: R506477402+ token: ZbbF51wzUqPGTMG3ngYRzSSDbLK3Ee9wdcW+ email: [email protected]customer_note:currency: USDlocale: en@@ -4583,8 +4583,8 @@ paths:variant_id: variant_UkLWZg9DAJquantity: 1currency: USD- name: Product 885251- slug: product-885251+ name: Product 883927+ slug: product-883927options_text: ''price: '10.0'display_price: "$10.00"@@ -4609,7 +4609,7 @@ paths:digital_links: []fulfillments:- id: ful_UkLWZg9DAJ- number: H21042794370+ number: H66163861804tracking: U10000tracking_url:cost: '100.0'@@ -4638,7 +4638,7 @@ paths:stock_location:id: sloc_UkLWZg9DAJstate_abbr: NY- name: Meri O'Hara+ name: Faye Kertzmannaddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'@@ -4781,9 +4781,9 @@ paths:example:id: cart_UkLWZg9DAJmarket_id:- number: R735538070- token: pJmy9PSsevBtccAFgssJj5xxWh7Zx2avpvg- email: [email protected]+ number: R787693305+ token: naZG9yps6zPNYyBArZBgKKY6nnqYpGC5rTw+ email: [email protected]customer_note:currency: USDlocale: en@@ -4827,8 +4827,8 @@ paths:variant_id: variant_UkLWZg9DAJquantity: 1currency: USD- name: Product 90269- slug: product-90269+ name: Product 905832+ slug: product-905832options_text: ''price: '10.0'display_price: "$10.00"@@ -4853,7 +4853,7 @@ paths:digital_links: []fulfillments:- id: ful_UkLWZg9DAJ- number: H61990909745+ number: H48213234073tracking: U10000tracking_url:cost: '100.0'@@ -4882,7 +4882,7 @@ paths:stock_location:id: sloc_UkLWZg9DAJstate_abbr: NY- name: Gianna Prosacco+ name: Kerri Hahnaddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'@@ -5039,9 +5039,9 @@ paths:example:id: cart_UkLWZg9DAJmarket_id:- number: R786565483- token: rPCVCzH2MAhdyzFpsLwftnwAWtyVzCAuH5j- email: [email protected]+ number: R501407956+ token: mBMtKueSANaxHuT7o3H1zs5CWXfBtLZR76a+ email: [email protected]customer_note:currency: USDlocale: en@@ -5080,8 +5080,8 @@ paths:variant_id: variant_UkLWZg9DAJquantity: 1currency: USD- name: Product 924064- slug: product-924064+ name: Product 923228+ slug: product-923228options_text: ''price: '10.0'display_price: "$10.00"@@ -5106,7 +5106,7 @@ paths:digital_links: []fulfillments:- id: ful_UkLWZg9DAJ- number: H72899618600+ number: H63891944560tracking: U10000tracking_url:cost: '100.0'@@ -5135,7 +5135,7 @@ paths:stock_location:id: sloc_UkLWZg9DAJstate_abbr: NY- name: Hoa Abshire+ name: Julieann Kuhnaddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'@@ -5164,8 +5164,8 @@ paths:payments:- id: py_UkLWZg9DAJpayment_method_id: pm_UkLWZg9DAJ- response_code: 1-SC-20260521140122745447- number: PKDTTE1C+ response_code: 1-SC-20260521181222228580+ number: PLBPL882amount: '50.0'display_amount: "$50.00"status: checkout@@ -5344,9 +5344,9 @@ paths:example:id: cart_UkLWZg9DAJmarket_id:- number: R305341957- token: cYad5ZEwRxucQSrUZeYvDNJJeNzFMkpais6- email: [email protected]+ number: R971301843+ token: TAXrAS6nE34CGB4J4SM9jYAC7D1LAfEdvuB+ email: [email protected]customer_note:currency: USDlocale: en@@ -5388,8 +5388,8 @@ paths:variant_id: variant_UkLWZg9DAJquantity: 1currency: USD- name: Product 967644- slug: product-967644+ name: Product 966445+ slug: product-966445options_text: ''price: '10.0'display_price: "$10.00"@@ -5414,7 +5414,7 @@ paths:digital_links: []fulfillments:- id: ful_UkLWZg9DAJ- number: H87527277081+ number: H50426852278tracking: U10000tracking_url:cost: '100.0'@@ -5443,7 +5443,7 @@ paths:stock_location:id: sloc_UkLWZg9DAJstate_abbr: NY- name: Marget Carter+ name: Hilda Gorczanyaddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'@@ -5472,8 +5472,8 @@ paths:payments:- id: py_UkLWZg9DAJpayment_method_id: pm_UkLWZg9DAJ- response_code: 1-SC-20260521140125170061- number: P247ASB1+ response_code: 1-SC-20260521181224917306+ number: P50IZG86amount: '50.0'display_amount: "$50.00"status: invalid@@ -5597,7 +5597,7 @@ paths:example:data:- id: gc_UkLWZg9DAJ- code: 5F5907332CD24C13+ code: DFE1B771D0A9F320status: activecurrency: USDamount: '10.0'@@ -5693,7 +5693,7 @@ paths:application/json:example:id: gc_UkLWZg9DAJ- code: E7D8EEDBD8B38629+ code: B3971A4B112F7143status: activecurrency: USDamount: '10.0'@@ -5784,9 +5784,9 @@ paths:example:id: cart_UkLWZg9DAJmarket_id:- number: R898038455- token: kwoDUG5ytVevnyteMSLq11LFUoUeQvgvj3C- email: [email protected]+ number: R881799706+ token: RVbjRddtDRtcExjXQRpMB8Bim5LNSShGBH6+ email: [email protected]customer_note:currency: USDlocale: en@@ -5834,8 +5834,8 @@ paths:variant_id: variant_UkLWZg9DAJquantity: 1currency: USD- name: Product 998774- slug: product-998774+ name: Product 996441+ slug: product-996441options_text: ''price: '10.0'display_price: "$10.00"@@ -5862,8 +5862,8 @@ paths:variant_id: variant_gbHJdmfrXBquantity: 1currency: USD- name: Product 1007565- slug: product-1007565+ name: Product 1009810+ slug: product-1009810options_text: ''price: '19.99'display_price: "$19.99"@@ -6006,9 +6006,9 @@ paths:example:id: cart_UkLWZg9DAJmarket_id:- number: R361093646- token: ANzLKaHuynyv78jwmNXN17TGQvYaPbpDZpf- email: [email protected]+ number: R794423726+ token: 1sJMUmLYsh3UaeGjL4VQKgK3DMj8h2YAx2z+ email: [email protected]customer_note:currency: USDlocale: en@@ -6053,8 +6053,8 @@ paths:variant_id: variant_UkLWZg9DAJquantity: 1currency: USD- name: Product 1032574- slug: product-1032574+ name: Product 1039114+ slug: product-1039114options_text: ''price: '10.0'display_price: "$10.00"@@ -6177,9 +6177,9 @@ paths:example:id: cart_UkLWZg9DAJmarket_id:- number: R782177832- token: 3qTD9CqYFu8if2zPw9fjYJT6bcLLBXgqdkB- email: [email protected]+ number: R184817343+ token: vPBcAwTjPCjFLRYvznh9D9dkaWZt8aapnyH+ email: [email protected]customer_note:currency: USDlocale: en@@ -6723,17 +6723,24 @@ paths:- If the email is already verified for this store, the existing subscription is returned unchanged.- If the request is unauthenticated (guest), the subscription is created in an unverified state- and a `newsletter_subscriber.subscription_requested` event is published containing the- `verification_token` and the validated `redirect_url`. Storefronts subscribe to this event- via a webhook to send the confirmation email; the link should point at- `redirect_url?token=<verification_token>` and call `POST /newsletter_subscribers/verify`+ and two events are published: `newsletter_subscriber.subscription_requested` (carrying the+ `verification_token` and the validated `redirect_url`, intended for headless storefronts that+ want to send the confirmation email themselves via a webhook handler) and the legacy+ `newsletter_subscriber.subscribed` lifecycle event (which the bundled `spree_emails` package+ listens to and uses to send a default confirmation email). The confirmation link should point+ at `redirect_url?token=<verification_token>` and call `POST /newsletter_subscribers/verify`when the user clicks it.- If the request is authenticated via JWT and the customer's email matches the subscribed email,- the subscription is auto-verified — no event is fired.+ the subscription is auto-verified and no events are fired — the JWT already proves email+ ownership, so no confirmation email is needed.- The optional `redirect_url` is where the verification token should land on the storefront. It is- validated against the store's [Allowed Origins](/developer/core-concepts/allowed-origins) and- silently dropped from the webhook payload if it does not match (secure-by-default).+ The optional `redirect_url` is where the verification token should land on the storefront. The+ server does not return a validation error when the URL is outside the store's+ [Allowed Origins](/developer/core-concepts/allowed-origins); instead, the URL is silently+ omitted from the webhook payload (secure-by-default). When no allow-list is configured on the+ store, the URL is also omitted. Callers therefore receive the same 201 regardless, and the+ webhook handler should fall back to the store's storefront URL when `redirect_url` is missing+ from the payload.Newsletter consent is preserved across registration: if a guest subscribes and later registerswith the same email, the existing subscriber record is reused.@@ -6775,11 +6782,11 @@ paths:application/json:example:id: sub_UkLWZg9DAJ- email: [email protected]- created_at: '2026-05-21T14:01:32.605Z'- updated_at: '2026-05-21T14:01:32.605Z'+ email: [email protected]+ created_at: '2026-05-21T18:12:32.551Z'+ updated_at: '2026-05-21T18:12:32.553Z'verified: true- verified_at: '2026-05-21T14:01:32Z'+ verified_at: '2026-05-21T18:12:32Z'customer_id: cus_UkLWZg9DAJschema:"$ref": "#/components/schemas/NewsletterSubscriber"@@ -6811,7 +6818,9 @@ paths:format: uriexample: https://your-store.com/newsletter/confirmdescription: Storefront URL the verification token should be appended- to. Must be in the store's allowed origins.+ to. Silently omitted from the webhook payload when the store has+ allowed origins configured and this URL does not match one of+ them, or when no allowed origins are configured at all.required:"/api/v3/store/newsletter_subscribers/verify":@@ -6856,10 +6865,10 @@ paths:example:id: sub_UkLWZg9DAJemail: [email protected]- created_at: '2026-05-21T14:01:32.629Z'- updated_at: '2026-05-21T14:01:32.640Z'+ created_at: '2026-05-21T18:12:32.578Z'+ updated_at: '2026-05-21T18:12:32.591Z'verified: true- verified_at: '2026-05-21T14:01:32Z'+ verified_at: '2026-05-21T18:12:32Z'customer_id:schema:"$ref": "#/components/schemas/NewsletterSubscriber"@@ -6957,7 +6966,7 @@ paths:id: or_UkLWZg9DAJmarket_id:channel_id: ch_UkLWZg9DAJ- number: R219546930+ number: R444420762email: [email protected]customer_note:currency: USD@@ -6985,7 +6994,7 @@ paths:display_delivery_total: "$100.00"fulfillment_status:payment_status:- completed_at: '2026-05-21T14:01:33.348Z'+ completed_at: '2026-05-21T18:12:33.331Z'store_credit_total: '0.0'display_store_credit_total: "$0.00"covered_by_store_credit: false@@ -6995,8 +7004,8 @@ paths:variant_id: variant_UkLWZg9DAJquantity: 1currency: USD- name: Product 1078893- slug: product-1078893+ name: Product 1079404+ slug: product-1079404options_text: ''price: '10.0'display_price: "$10.00"@@ -7021,7 +7030,7 @@ paths:digital_links: []fulfillments:- id: ful_UkLWZg9DAJ- number: H66784286474+ number: H37244671113tracking: U10000tracking_url:cost: '100.0'@@ -7050,7 +7059,7 @@ paths:stock_location:id: sloc_UkLWZg9DAJstate_abbr: NY- name: Naida Boyer+ name: Bud Bartolettiaddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'@@ -7195,9 +7204,9 @@ paths:id: ps_gbHJdmfrXBstatus: pendingcurrency: USD- external_id: bogus_a17b47e0398d13f0b001d373+ external_id: bogus_799f9d0cdd2a024b44a972f2external_data:- client_secret: bogus_secret_5dec9b38272306eb+ client_secret: bogus_secret_e705380ff182660ecustomer_external_id:expires_at:amount: '110.0'@@ -7295,7 +7304,7 @@ paths:id: ps_UkLWZg9DAJstatus: pendingcurrency: USD- external_id: bogus_9d936b37603e2d2e9f882ba5+ external_id: bogus_aecf7276c91c09ca9e9ec79aexternal_data:client_secret: secret_123customer_external_id:@@ -7357,7 +7366,7 @@ paths:id: ps_UkLWZg9DAJstatus: pendingcurrency: USD- external_id: bogus_62a32b13abfdf70ffe97ebfe+ external_id: bogus_4d892ef9777434a81f39f60dexternal_data:client_secret: secret_123customer_external_id:@@ -7459,7 +7468,7 @@ paths:id: ps_UkLWZg9DAJstatus: completedcurrency: USD- external_id: bogus_690fbde1d19bee42865caa8f+ external_id: bogus_a8a35246fb9e9da3d0a251b8external_data:client_secret: secret_123customer_external_id:@@ -7544,8 +7553,8 @@ paths:example:id: pss_gbHJdmfrXBstatus: pending- external_id: bogus_seti_c30c9b5f22811f96e01ae78e- external_client_secret: bogus_seti_secret_4c73525f5d30ff33+ external_id: bogus_seti_c85316f2ab8114ec81687ed4+ external_client_secret: bogus_seti_secret_a15e9cd71178a98cexternal_data: {}payment_method_id: pm_UkLWZg9DAJpayment_source_id:@@ -7644,8 +7653,8 @@ paths:example:id: pss_UkLWZg9DAJstatus: pending- external_id: seti_test_d7fa0cbdbc9e070360f09d67- external_client_secret: seti_secret_890b28449262f42d588f7226+ external_id: seti_test_674107c9a4a65317bbdc129d+ external_client_secret: seti_secret_66eb1d151fa172598a741e14external_data:client_secret: secret_123payment_method_id: pm_UkLWZg9DAJ@@ -7721,8 +7730,8 @@ paths:example:id: pss_UkLWZg9DAJstatus: completed- external_id: seti_test_0deba6c34d39f196388036e2- external_client_secret: seti_secret_c8e8baf1be390bcebea53f33+ external_id: seti_test_047d39fe078d8f5dfb59fc7a+ external_client_secret: seti_secret_8320035d2ef40c47c4e63f5bexternal_data:client_secret: secret_123payment_method_id: pm_UkLWZg9DAJ@@ -7816,7 +7825,7 @@ paths:id: py_UkLWZg9DAJpayment_method_id: pm_UkLWZg9DAJresponse_code:- number: P8EAYC6L+ number: PDW8QZGMamount: '110.0'display_amount: "$110.00"status: checkout@@ -7912,7 +7921,7 @@ paths:body_html: ''- id: pol_OIJLhNcSbfname: Privacy Policy- slug: privacy-policy-e33e52be-144d-4d70-99a2-978929d3c22a+ slug: privacy-policy-64c6fe11-a85d-4ac3-bcf3-2d7e2f51e471body: We respect your privacy.body_html: |<div class="trix-content">@@ -8156,13 +8165,13 @@ paths:example:data:- id: prod_UkLWZg9DAJ- name: Product 1173606- slug: product-1173606+ name: Product 117952+ slug: product-117952meta_title:meta_description:meta_keywords:variant_count: 1- available_on: '2025-05-21T14:01:43.412Z'+ available_on: '2025-05-21T18:12:43.946Z'purchasable: truein_stock: falsebackorderable: true@@ -8184,29 +8193,34 @@ paths:price_list_id:original_price:- id: prod_gbHJdmfrXB- name: Product 1189963- slug: product-1189963+ name: Product 1184416+ slug: product-1184416meta_title:meta_description:meta_keywords:variant_count: 0- available_on: '2025-05-21T14:01:43.466Z'+ available_on: '2025-05-21T18:12:44.008Z'purchasable: truein_stock: falsebackorderable: trueavailable: true- description: Nobis autem cum dolorum nesciunt harum sequi voluptates.- Sunt qui hic libero exercitationem ratione iusto. Vero odit quia- assumenda minus similique corrupti a. Iste aliquam temporibus- et aliquid beatae. Placeat odit voluptates molestias quam accusantium- natus sed. Ut vero cumque delectus consectetur rem. Quae nam repudiandae- corporis voluptate. Debitis rerum a recusandae sit dolorum earum- fugiat ea. Praesentium alias veritatis molestias neque incidunt- laudantium doloribus. Quo non eum placeat dolorem.+ description: Impedit quam aliquid ducimus magni. Quas nulla placeat+ totam suscipit doloribus quos inventore earum. Veniam officiis+ ad ipsum sed optio error perferendis. Doloremque molestias magnam+ harum consequatur at accusamus tempore sunt. Deleniti voluptatum+ laborum vero nisi. Sunt delectus soluta amet hic consequuntur+ occaecati. Molestias illum minima velit ullam. Modi animi temporibus+ adipisci veritatis voluptatum libero unde. Sunt mollitia tenetur+ fugit enim. Accusantium minima id culpa laudantium molestias.+ Rerum saepe necessitatibus repellat tempora quis. Unde saepe laborum+ iure non quisquam nesciunt sed. Voluptas debitis placeat asperiores+ dolorem quia facilis rem. Atque quae enim at quis accusamus sequi+ vel.description_html: |-- Nobis autem cum dolorum nesciunt harum sequi voluptates. Sunt qui hic libero exercitationem ratione iusto. Vero odit quia assumenda minus similique corrupti a.- Iste aliquam temporibus et aliquid beatae. Placeat odit voluptates molestias quam accusantium natus sed. Ut vero cumque delectus consectetur rem. Quae nam repudiandae corporis voluptate.- Debitis rerum a recusandae sit dolorum earum fugiat ea. Praesentium alias veritatis molestias neque incidunt laudantium doloribus. Quo non eum placeat dolorem.+ Impedit quam aliquid ducimus magni. Quas nulla placeat totam suscipit doloribus quos inventore earum. Veniam officiis ad ipsum sed optio error perferendis.+ Doloremque molestias magnam harum consequatur at accusamus tempore sunt. Deleniti voluptatum laborum vero nisi. Sunt delectus soluta amet hic consequuntur occaecati.+ Molestias illum minima velit ullam. Modi animi temporibus adipisci veritatis voluptatum libero unde. Sunt mollitia tenetur fugit enim. Accusantium minima id culpa laudantium molestias.+ Rerum saepe necessitatibus repellat tempora quis. Unde saepe laborum iure non quisquam nesciunt sed. Voluptas debitis placeat asperiores dolorem quia facilis rem. Atque quae enim at quis accusamus sequi vel.default_variant_id: variant_EfhxLZ9ck8thumbnail_url:tags: []@@ -8308,13 +8322,13 @@ paths:application/json:example:id: prod_UkLWZg9DAJ- name: Product 1451391- slug: product-1451391+ name: Product 1453321+ slug: product-1453321meta_title:meta_description:meta_keywords:variant_count: 1- available_on: '2025-05-21T14:01:44.847Z'+ available_on: '2025-05-21T18:12:45.816Z'purchasable: truein_stock: falsebackorderable: true@@ -8341,7 +8355,7 @@ paths:amount_in_cents: 999currency: USDdisplay_amount: "$9.99"- recorded_at: '2026-05-06T14:01:44Z'+ recorded_at: '2026-05-06T18:12:45Z'schema:"$ref": "#/components/schemas/Product"'404':@@ -8716,9 +8730,9 @@ paths:example:id: cart_UkLWZg9DAJmarket_id:- number: R744140023- token: pTFm3XRZudeeoLXmviqWz6uNkVtaBp4uLrV- email: [email protected]+ number: R563436707+ token: MEKMkDqDZiwtriHVLkLzxZ7hGj4nxCtmBig+ email: [email protected]customer_note:currency: USDlocale: en@@ -8757,8 +8771,8 @@ paths:variant_id: variant_UkLWZg9DAJquantity: 1currency: USD- name: Product 1658176- slug: product-1658176+ name: Product 1657+ slug: product-1657options_text: ''price: '10.0'display_price: "$10.00"@@ -8783,7 +8797,7 @@ paths:digital_links: []fulfillments:- id: ful_UkLWZg9DAJ- number: H59588366435+ number: H22654230230tracking: U10000tracking_url:cost: '100.0'@@ -8812,7 +8826,7 @@ paths:stock_location:id: sloc_UkLWZg9DAJstate_abbr: NY- name: Veta Mitchell+ name: Marissa Sipesaddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'@@ -8841,8 +8855,8 @@ paths:payments:- id: py_UkLWZg9DAJpayment_method_id: pm_UkLWZg9DAJ- response_code: 1-SC-20260521140150066371- number: PEHXTQG6+ response_code: 1-SC-20260521181251050531+ number: PFR3QR4Hamount: '10.0'display_amount: "$10.00"status: checkout@@ -8985,9 +8999,9 @@ paths:example:id: cart_UkLWZg9DAJmarket_id:- number: R244936382- token: Ycdv7VgR4x426YxWUz7eoyGEFZ1sRY4SpaC- email: [email protected]+ number: R554787846+ token: vfB6PnFw9cPg6LbJqQKBA7jHh5zQGzRLtnz+ email: [email protected]customer_note:currency: USDlocale: en@@ -9029,8 +9043,8 @@ paths:variant_id: variant_UkLWZg9DAJquantity: 1currency: USD- name: Product 1673068- slug: product-1673068+ name: Product 1673494+ slug: product-1673494options_text: ''price: '10.0'display_price: "$10.00"@@ -9055,7 +9069,7 @@ paths:digital_links: []fulfillments:- id: ful_UkLWZg9DAJ- number: H49623074593+ number: H45381203670tracking: U10000tracking_url:cost: '100.0'@@ -9084,7 +9098,7 @@ paths:stock_location:id: sloc_UkLWZg9DAJstate_abbr: NY- name: Grady Pacocha+ name: Ozella Hirtheaddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'@@ -9214,7 +9228,7 @@ paths:data:- id: wl_UkLWZg9DAJname: My Wishlist- token: QL7gtUL5AUfgexgDh9iQFWaA+ token: czkimqa2wGQpziZPiHu4TETDis_default: falseis_private: truemeta:@@ -9290,7 +9304,7 @@ paths:example:id: wl_gbHJdmfrXBname: Birthday Ideas- token: zmk9bk8qkYJRXzjhxhYRV1Gg+ token: HkhGZqtmkmgvuTiENz7zMHwAis_default: falseis_private: trueschema:@@ -9386,7 +9400,7 @@ paths:example:id: wl_UkLWZg9DAJname: My Wishlist- token: FjFxxfkdRu9GRLaAmWerHsP1+ token: URczbyJbeCgRS1a82JhitHvQis_default: falseis_private: trueschema:@@ -9448,7 +9462,7 @@ paths:example:id: wl_UkLWZg9DAJname: Updated Name- token: zTCwhxBSEZYoDbdjgF57VnYE+ token: RbsVopS8AJBteR6s51rRT9tNis_default: falseis_private: trueschema:diff --git a/packages/sdk/.changeset/store-newsletter-subscribers.md b/packages/sdk/.changeset/store-newsletter-subscribers.mdindex 78d749fe4a..d257b6ed2c 100644--- a/packages/sdk/.changeset/store-newsletter-subscribers.md+++ b/packages/sdk/.changeset/store-newsletter-subscribers.md@@ -5,3 +5,5 @@Add `client.newsletterSubscribers.create()` and `client.newsletterSubscribers.verify()` for the new Store API newsletter subscription endpoints.Lets headless storefronts subscribe guests to the newsletter before account creation and confirm the double opt-in via the verification token from the confirmation email. Pass `redirect_url` on `create()` and the storefront receives a `newsletter_subscriber.subscription_requested` webhook with the token + validated redirect URL so it can send the confirmation email itself — same pattern as `customer.password_reset_requested`. When called with a JWT and the customer's own email, the subscription is auto-verified.++Consent is now preserved across registration: when `client.customers.create()` is called with an email that already has a newsletter subscription on the current store, that subscriber is linked to the new user. If the subscription was verified, `accepts_email_marketing` is set to `true` on the returned customer even when the registration body sent `false` — so guests who opted in before signing up don't lose their consent.diff --git a/packages/sdk/examples/newsletter-subscribers/create.ts b/packages/sdk/examples/newsletter-subscribers/create.tsindex 2e560d4573..c1369032a2 100644--- a/packages/sdk/examples/newsletter-subscribers/create.ts+++ b/packages/sdk/examples/newsletter-subscribers/create.ts@@ -8,9 +8,6 @@ const client = createClient({// region:exampleconst subscriber = await client.newsletterSubscribers.create({email: '[email protected]',- // Where the verification token should land. Must be in the store's- // allowed origins. The storefront's webhook handler will send the- // confirmation email with a link to `<redirect_url>?token=<token>`.redirect_url: 'https://your-store.com/newsletter/confirm',})// endregion:examplediff --git a/packages/sdk/src/store-client.ts b/packages/sdk/src/store-client.tsindex fb1b30f883..0613634034 100644--- a/packages/sdk/src/store-client.ts+++ b/packages/sdk/src/store-client.ts@@ -609,21 +609,10 @@ export class StoreClient {readonly newsletterSubscribers = {/*** Subscribe an email address to the newsletter for the current store.- *- * Behavior:- * - If the email already has a verified subscription, the existing record is returned unchanged.- * - Guest subscriptions are created in an unverified state and a- * `newsletter_subscriber.subscription_requested` webhook event is fired with the- * verification token + validated `redirect_url`; the storefront sends the- * confirmation email and the link points at `redirect_url?token=...`.- * - When the call is authenticated via JWT and the customer's email matches the subscribed- * email, the subscription is auto-verified — no confirmation email is sent.- *- * `redirect_url` must match one of the store's allowed origins (see Allowed Origins- * in the admin). If it does not, it is silently dropped from the webhook payload to- * prevent open-redirect / token-exfiltration attacks.- *- * Pass `options.token` (JWT) to link the subscription to an authenticated customer.+ * Guests get an unverified record; pass a JWT via `options.token` to link+ * to a customer (auto-verifies when the JWT email matches `params.email`).+ * `redirect_url` is dropped from the webhook payload when it's not in the+ * store's allowed origins.*/create: (params: { email: string; redirect_url?: string },@@ -635,9 +624,7 @@ export class StoreClient {}),/**- * Confirm a pending newsletter subscription using the verification token from the- * confirmation email. On success the subscriber is marked verified and, when linked- * to a customer, that customer's `accepts_email_marketing` flag is set to `true`.+ * Confirm a pending subscription using the token from the confirmation email.*/verify: (params: { token: string }, options?: RequestOptions): Promise<NewsletterSubscriber> =>this.request<NewsletterSubscriber>('POST', '/newsletter_subscribers/verify', {diff --git a/spree/api/app/controllers/spree/api/v3/store/customers_controller.rb b/spree/api/app/controllers/spree/api/v3/store/customers_controller.rbindex 11ddb45d31..d084d93f99 100644--- a/spree/api/app/controllers/spree/api/v3/store/customers_controller.rb+++ b/spree/api/app/controllers/spree/api/v3/store/customers_controller.rb@@ -13,6 +13,7 @@ module Spreeuser = Spree.user_class.new(permitted_params.except(:current_password))if user.save+ link_matching_newsletter_subscriber!(user)refresh_token = Spree::RefreshToken.create_for(user, request_env: {ip_address: request.remote_ip,user_agent: request.user_agent&.truncate(255)@@ -94,6 +95,11 @@ module Spreedef user_serializerSpree.api.customer_serializerend++ def link_matching_newsletter_subscriber!(user)+ subscriber = Spree::NewsletterSubscriber.find_by(email: user.email, store: current_store)+ Spree::Newsletter::LinkUser.new(subscriber: subscriber, user: user).call+ endendendenddiff --git a/spree/api/app/controllers/spree/api/v3/store/newsletter_subscribers_controller.rb b/spree/api/app/controllers/spree/api/v3/store/newsletter_subscribers_controller.rbindex dab5b0422e..8c36e07c94 100644--- a/spree/api/app/controllers/spree/api/v3/store/newsletter_subscribers_controller.rb+++ b/spree/api/app/controllers/spree/api/v3/store/newsletter_subscribers_controller.rb@@ -9,23 +9,7 @@ module Spreeonly: [:create, :verify],with: RATE_LIMIT_RESPONSE- # Authentication is optional — the parent's `before_action :authenticate_user`- # leaves `current_user` nil when no JWT is present, which is the guest path.- # When a JWT *is* present, we use it to link the subscription to the customer- # (and auto-verify if the email matches).-# POST /api/v3/store/newsletter_subscribers- # Subscribes a guest or authenticated customer to the newsletter for the current store.- # If the email already has a verified subscription, returns the existing record.- # If a JWT is provided, the subscription is linked to that customer; if the customer's- # email matches the subscribed email, the subscription is auto-verified.- #- # The optional `redirect_url` is the storefront page that should receive the- # verification token (e.g. `https://your-store.com/newsletter/confirm`). When- # provided, it is validated against the store's allowed origins and forwarded- # in the `newsletter_subscriber.subscription_requested` event so the storefront- # webhook handler can build the confirmation email link as- # `redirect_url?token=<verification_token>`.def createsubscriber = Spree::NewsletterSubscriber.subscribe(email: params[:email],@@ -42,8 +26,6 @@ module Spreeend# POST /api/v3/store/newsletter_subscribers/verify- # Confirms a newsletter subscription using the verification token sent by email.- # Accepts: { "token": "..." }def verifytoken = params[:token]@@ -78,13 +60,12 @@ module Spreeprivate- # Validates the requested redirect_url against the current store's allowed- # origins. Returns nil (the link will be dropped from the event) when the URL- # is not in the allow-list — same secure-by-default behavior as password resets.+ # Drop redirect_url when it isn't in the store's allow-list — secure-by-default,+ # mirrors password_resets. Returning nil omits it from the webhook payload rather+ # than rejecting the request, so callers can't probe the allow-list via 4xx errors.def validated_redirect_urlredirect_url = params[:redirect_url]return nil if redirect_url.blank?- return nil unless current_store.allowed_origins.exists?return nil unless current_store.allowed_origin?(redirect_url)redirect_urldiff --git a/spree/api/spec/controllers/spree/api/v3/store/customers_controller_spec.rb b/spree/api/spec/controllers/spree/api/v3/store/customers_controller_spec.rbindex fbbd0135ec..1d8a25c155 100644--- a/spree/api/spec/controllers/spree/api/v3/store/customers_controller_spec.rb+++ b/spree/api/spec/controllers/spree/api/v3/store/customers_controller_spec.rb@@ -72,6 +72,45 @@ RSpec.describe Spree::Api::V3::Store::CustomersController, type: :controller doexpect(new_user.metadata).to eq({ 'source' => 'storefront' })end+ context 'with a matching newsletter subscriber on the current store' do+ it 'links an existing unverified subscriber to the new user without auto-opting them in' do+ subscriber = create(+ :newsletter_subscriber,+ :unverified,+ email: valid_params[:email],+ user: nil,+ store: store+ )++ post :create, params: valid_params++ expect(response).to have_http_status(:created)+ new_user = Spree.user_class.find_by(email: valid_params[:email])+ expect(subscriber.reload.user).to eq(new_user)+ expect(new_user.accepts_email_marketing).to eq(false)+ end++ it 'links an existing verified subscriber and carries the opt-in onto the new user' do+ subscriber = create(+ :newsletter_subscriber,+ :verified,+ email: valid_params[:email],+ user: nil,+ store: store+ )++ # Earlier guest consent should win even when the registration body sends+ # accepts_email_marketing=false.+ post :create, params: valid_params.merge(accepts_email_marketing: false)++ expect(response).to have_http_status(:created)+ new_user = Spree.user_class.find_by(email: valid_params[:email])+ expect(subscriber.reload.user).to eq(new_user)+ expect(new_user.accepts_email_marketing).to eq(true)+ expect(json_response['user']['accepts_email_marketing']).to eq(true)+ end+ end+context 'validation errors' doit 'returns validation error for blank email' dopost :create, params: { email: '', password: 'password123', password_confirmation: 'password123' }diff --git a/spree/api/spec/integration/spree/api/v3/store/newsletter_subscribers_spec.rb b/spree/api/spec/integration/spree/api/v3/store/newsletter_subscribers_spec.rbindex ffdedc90c7..8538e5eefc 100644--- a/spree/api/spec/integration/spree/api/v3/store/newsletter_subscribers_spec.rb+++ b/spree/api/spec/integration/spree/api/v3/store/newsletter_subscribers_spec.rb@@ -18,17 +18,24 @@ RSpec.describe 'Newsletter Subscribers API', type: :request, swagger_doc: 'api-r- If the email is already verified for this store, the existing subscription is returned unchanged.- If the request is unauthenticated (guest), the subscription is created in an unverified state- and a `newsletter_subscriber.subscription_requested` event is published containing the- `verification_token` and the validated `redirect_url`. Storefronts subscribe to this event- via a webhook to send the confirmation email; the link should point at- `redirect_url?token=<verification_token>` and call `POST /newsletter_subscribers/verify`+ and two events are published: `newsletter_subscriber.subscription_requested` (carrying the+ `verification_token` and the validated `redirect_url`, intended for headless storefronts that+ want to send the confirmation email themselves via a webhook handler) and the legacy+ `newsletter_subscriber.subscribed` lifecycle event (which the bundled `spree_emails` package+ listens to and uses to send a default confirmation email). The confirmation link should point+ at `redirect_url?token=<verification_token>` and call `POST /newsletter_subscribers/verify`when the user clicks it.- If the request is authenticated via JWT and the customer's email matches the subscribed email,- the subscription is auto-verified — no event is fired.+ the subscription is auto-verified and no events are fired — the JWT already proves email+ ownership, so no confirmation email is needed.- The optional `redirect_url` is where the verification token should land on the storefront. It is- validated against the store's [Allowed Origins](/developer/core-concepts/allowed-origins) and- silently dropped from the webhook payload if it does not match (secure-by-default).+ The optional `redirect_url` is where the verification token should land on the storefront. The+ server does not return a validation error when the URL is outside the store's+ [Allowed Origins](/developer/core-concepts/allowed-origins); instead, the URL is silently+ omitted from the webhook payload (secure-by-default). When no allow-list is configured on the+ store, the URL is also omitted. Callers therefore receive the same 201 regardless, and the+ webhook handler should fall back to the store's storefront URL when `redirect_url` is missing+ from the payload.Newsletter consent is preserved across registration: if a guest subscribes and later registerswith the same email, the existing subscriber record is reused.@@ -47,7 +54,7 @@ RSpec.describe 'Newsletter Subscribers API', type: :request, swagger_doc: 'api-rtype: :string,format: 'uri',example: 'https://your-store.com/newsletter/confirm',- description: 'Storefront URL the verification token should be appended to. Must be in the store\'s allowed origins.'+ description: 'Storefront URL the verification token should be appended to. Silently omitted from the webhook payload when the store has allowed origins configured and this URL does not match one of them, or when no allowed origins are configured at all.'}},required: %w[email]diff --git a/spree/core/app/services/spree/newsletter/link_user.rb b/spree/core/app/services/spree/newsletter/link_user.rbnew file mode 100644index 0000000000..3e8a153c27--- /dev/null+++ b/spree/core/app/services/spree/newsletter/link_user.rb@@ -0,0 +1,53 @@+module Spree+ module Newsletter+ # Reconciles a Spree::NewsletterSubscriber with the customer who owns the email.+ # Backfills the user link and propagates verified opt-in onto the user record so+ # consent given before account creation isn't silently lost on registration.+ #+ # Best-effort: validation failures are logged but never re-raised. Callers are+ # already past the point where rolling back makes sense (the user record exists,+ # the subscription exists). This is reconciliation, not a precondition.+ class LinkUser+ def initialize(subscriber:, user:)+ @subscriber = subscriber+ @user = user+ end++ def call+ return if subscriber.blank? || user.blank?+ return if subscriber.user_id == user.id && !needs_marketing_propagation?++ link_subscriber_to_user+ propagate_marketing_consent if needs_marketing_propagation?++ subscriber+ end++ private++ attr_reader :subscriber, :user++ def link_subscriber_to_user+ return if subscriber.user_id == user.id++ return if subscriber.update(user: user)++ Rails.logger.warn(+ "NewsletterSubscriber #{subscriber.id} link to user #{user.id} failed: #{subscriber.errors.full_messages.to_sentence}"+ )+ end++ def needs_marketing_propagation?+ subscriber.verified? && !user.accepts_email_marketing?+ end++ def propagate_marketing_consent+ return if user.update(accepts_email_marketing: true)++ Rails.logger.warn(+ "User #{user.id} accepts_email_marketing update failed: #{user.errors.full_messages.to_sentence}"+ )+ end+ end+ end+enddiff --git a/spree/core/app/services/spree/newsletter/subscribe.rb b/spree/core/app/services/spree/newsletter/subscribe.rbindex c2b304ec73..ade44c6e97 100644--- a/spree/core/app/services/spree/newsletter/subscribe.rb+++ b/spree/core/app/services/spree/newsletter/subscribe.rb@@ -9,19 +9,24 @@ module Spreeenddef call- return existed_subscription if existed_subscription.present?+ if existed_subscription.present?+ Spree::Newsletter::LinkUser.new(subscriber: existed_subscription, user: known_user).call+ return existed_subscription+ endActiveRecord::Base.transaction doupsert_subscriberreturn subscriber if subscriber.errors.any?+ Spree::Newsletter::LinkUser.new(subscriber: subscriber, user: known_user).call+if subscriber.email == current_user&.email- # no need to verified since user email is already verified+ # User's email is already verified by login — skip the double opt-in.Spree::Newsletter::Verify.new(subscriber: subscriber).callendend- publish_subscription_events unless subscriber.verified?+ subscriber.publish_event('newsletter_subscriber.subscription_requested', subscription_requested_payload) unless subscriber.verified?subscriberend@@ -29,25 +34,12 @@ module Spreeattr_reader :email, :current_user, :current_store, :redirect_url- def publish_subscription_events- subscriber.publish_event(- 'newsletter_subscriber.subscription_requested',- subscription_requested_payload- )-- # Legacy lifecycle event — kept for the bundled Spree::NewsletterMailer- # subscriber. Headless storefronts should listen to- # `newsletter_subscriber.subscription_requested` instead since it carries- # the verification_token and validated redirect_url.- subscriber.publish_event('newsletter_subscriber.subscribed')- end-def subscription_requested_payloadpayload = {id: subscriber.prefixed_id,email: subscriber.email,verification_token: subscriber.verification_token,- store_id: subscriber.store&.prefixed_id,+ store_id: current_store.prefixed_id,customer_id: subscriber.user&.prefixed_id}payload[:redirect_url] = redirect_url if redirect_url.present?@@ -56,7 +48,7 @@ module Spreedef upsert_subscriber@upsert_subscriber ||= Spree::NewsletterSubscriber.find_or_create_by(email: email, store: current_store) do |new_record|- new_record.user = Spree.user_class.find_by(email: new_record.email) || current_user+ new_record.user = known_userendendalias_method :subscriber, :upsert_subscriber@@ -64,6 +56,10 @@ module Spreedef existed_subscription@existed_subscription ||= Spree::NewsletterSubscriber.verified.find_by(email: email, store: current_store)end++ def known_user+ @known_user ||= current_user || Spree.user_class.find_by(email: email)+ endendendenddiff --git a/spree/core/spec/services/spree/newsletter/subscribe_spec.rb b/spree/core/spec/services/spree/newsletter/subscribe_spec.rbindex f853239e91..59596ababa 100644--- a/spree/core/spec/services/spree/newsletter/subscribe_spec.rb+++ b/spree/core/spec/services/spree/newsletter/subscribe_spec.rb@@ -32,7 +32,6 @@ module Spreeit 'does not publish any subscription events' doexpect_any_instance_of(Spree::NewsletterSubscriber).not_to receive(:publish_event).with('newsletter_subscriber.subscription_requested', anything)- expect_any_instance_of(Spree::NewsletterSubscriber).not_to receive(:publish_event).with('newsletter_subscriber.subscribed')serviceend@@ -79,13 +78,6 @@ module Spreeexpect(published[:payload]).not_to have_key(:redirect_url)end- it 'also publishes the legacy subscribed lifecycle event' do- expect_any_instance_of(Spree::NewsletterSubscriber).to receive(:publish_event).with('newsletter_subscriber.subscription_requested', anything)- expect_any_instance_of(Spree::NewsletterSubscriber).to receive(:publish_event).with('newsletter_subscriber.subscribed')-- service- end-it 'returns an instance of NewsletterSubscriber' doexpect(service).to be_a(NewsletterSubscriber)end@@ -123,10 +115,18 @@ module Spreeit 'does not publish any subscription events' doexpect_any_instance_of(Spree::NewsletterSubscriber).not_to receive(:publish_event).with('newsletter_subscriber.subscription_requested', anything)- expect_any_instance_of(Spree::NewsletterSubscriber).not_to receive(:publish_event).with('newsletter_subscriber.subscribed')serviceend++ context 'when a logged in user matches the subscription email' do+ let(:user) { create(:user, email: email, accepts_email_marketing: false) }++ it 'links the existing subscriber to the user and preserves consent' do+ expect(service.user).to eq(user)+ expect(user.reload.accepts_email_marketing).to eq(true)+ end+ endendcontext 'when unverified subscription has been already created' do@@ -142,10 +142,19 @@ module Spreeit 'publishes the subscription_requested event so the email is re-dispatched' doexpect_any_instance_of(Spree::NewsletterSubscriber).to receive(:publish_event).with('newsletter_subscriber.subscription_requested', anything).once- expect_any_instance_of(Spree::NewsletterSubscriber).to receive(:publish_event).with('newsletter_subscriber.subscribed').onceserviceend++ context 'when a logged in user matches the subscription email' do+ let(:user) { create(:user, email: email, accepts_email_marketing: false) }++ it 'links and verifies the existing subscriber' do+ expect(service.user).to eq(user)+ expect(service.reload).to be_verified+ expect(user.reload.accepts_email_marketing).to eq(true)+ end+ endendcontext 'when subscription does not exist for given store' dodiff --git a/spree/emails/app/mailers/spree/newsletter_mailer.rb b/spree/emails/app/mailers/spree/newsletter_mailer.rbindex 3fc955765f..b612160cd0 100644--- a/spree/emails/app/mailers/spree/newsletter_mailer.rb+++ b/spree/emails/app/mailers/spree/newsletter_mailer.rb@@ -1,9 +1,5 @@module Spreeclass NewsletterMailer < BaseMailer- # @param subscriber [Spree::NewsletterSubscriber]- # @param redirect_url [String, nil] Storefront page that handles the verification token.- # When provided, the link is built as `<redirect_url>?token=<verification_token>`.- # Falls back to `<store.storefront_url>/?token=<verification_token>` for legacy setups.def email_confirmation(subscriber, redirect_url: nil)@subscriber = subscriberstore = subscriber.store || Spree::Current.store || Spree::Store.default@@ -14,7 +10,15 @@ module Spreeprivate+ # URI-based merge preserves existing query params and fragments so the token+ # doesn't get swallowed by a `#section` or clobber an existing `?source=`.def append_token(url, token)+ uri = URI.parse(url.to_s)+ params = URI.decode_www_form(uri.query || '')+ params << ['token', token.to_s]+ uri.query = URI.encode_www_form(params)+ uri.to_s+ rescue URI::InvalidURIErrorseparator = url.include?('?') ? '&' : '?'"#{url}#{separator}token=#{CGI.escape(token.to_s)}"enddiff --git a/spree/emails/app/subscribers/spree/newsletter_subscriber_email_subscriber.rb b/spree/emails/app/subscribers/spree/newsletter_subscriber_email_subscriber.rbindex 4ddedc5f0b..fa47615912 100644--- a/spree/emails/app/subscribers/spree/newsletter_subscriber_email_subscriber.rb+++ b/spree/emails/app/subscribers/spree/newsletter_subscriber_email_subscriber.rb@@ -2,10 +2,6 @@module Spreeclass NewsletterSubscriberEmailSubscriber < Spree::Subscriber- # Listens to the `subscription_requested` event because that's where the- # validated storefront `redirect_url` is carried. The mailer needs that URL- # (or falls back to `store.storefront_url`) to build a verification link- # that actually points to the storefront's confirmation page.subscribes_to 'newsletter_subscriber.subscription_requested'def handle(event)diff --git a/spree/emails/spec/mailers/spree/newsletter_mailer_spec.rb b/spree/emails/spec/mailers/spree/newsletter_mailer_spec.rbindex 9bd87d7ac1..e6fcdf1a88 100644--- a/spree/emails/spec/mailers/spree/newsletter_mailer_spec.rb+++ b/spree/emails/spec/mailers/spree/newsletter_mailer_spec.rb@@ -17,6 +17,18 @@ describe Spree::NewsletterMailer, type: :mailer doexpect(message.body.encoded).to include("https://storefront.example.com/newsletter/confirm?source=footer&token=#{subscriber.verification_token}")end++ it 'preserves a URL fragment when appending the token' do+ message = described_class.email_confirmation(+ subscriber,+ redirect_url: 'https://storefront.example.com/account#newsletter'+ )++ # The token belongs in the query string, not after the fragment.+ expect(message.body.encoded).to include(+ "https://storefront.example.com/account?token=#{subscriber.verification_token}#newsletter"+ )+ endendcontext 'when no redirect_url is provided' do