From d8e6bbe938524acbb3a6888136ddd3c3ba81acd4 Mon Sep 17 00:00:00 2001 From: Jared Hoover Date: Tue, 21 Apr 2026 17:28:57 -0500 Subject: [PATCH 01/12] Add customer JSON import --- src/pages/rest/modules/import/index.md | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) diff --git a/src/pages/rest/modules/import/index.md b/src/pages/rest/modules/import/index.md index 6bfaa0a23..1385f48be 100644 --- a/src/pages/rest/modules/import/index.md +++ b/src/pages/rest/modules/import/index.md @@ -48,6 +48,31 @@ The `import/json` endpoint is designed for JSON data: * Convert your CSV into JSON using any trustworthy online converter. * When converting CSV to JSON using standard tools or libraries, special characters within the data are typically escaped automatically. Ensure that any manual edits or custom conversion processes handle this escaping appropriately. +#### Customer imports in Adobe Commerce as a Cloud Service + +In Adobe Commerce as a Cloud Service, the customer import API (POST /V1/import/json with entity: "customer") does not support assistance_allowed. Attempts to pass it as a field will result in a "Header contains invalid attribute(s): assistance_allowed" error. + +Alternatively, you can use `POST /V1/async/bulk/customers` to bulk create customers with assistance_allowed pre-enabled. + +```json +    { +      "customer": { +        "email": "user@example.com", +        "firstname": "User", +        "lastname": "One", +        "website_id": 1, +        "extension_attributes": {"assistance_allowed": 2} +      }, +      "password": "Password123!" +    } +``` + +Or individual existing customers using the `PUT /V1/customers/{id}` endpoint: + +```json +{"customer": {"extension_attributes": {"assistance_allowed": 2}}} +``` + ### Validation Strategy A validation strategy is mandatory. Depending on your chosen strategy, the API will either proceed with the import or abort it upon encountering invalid rows. From 5225a2dc6e83187b15fbbb8384bc93cf177f1170 Mon Sep 17 00:00:00 2001 From: Jared Hoover Date: Tue, 21 Apr 2026 17:37:05 -0500 Subject: [PATCH 02/12] cleanup --- src/pages/rest/modules/import/index.md | 46 ++++++++++++++------------ 1 file changed, 24 insertions(+), 22 deletions(-) diff --git a/src/pages/rest/modules/import/index.md b/src/pages/rest/modules/import/index.md index 1385f48be..5c826e6e1 100644 --- a/src/pages/rest/modules/import/index.md +++ b/src/pages/rest/modules/import/index.md @@ -50,28 +50,30 @@ The `import/json` endpoint is designed for JSON data: #### Customer imports in Adobe Commerce as a Cloud Service -In Adobe Commerce as a Cloud Service, the customer import API (POST /V1/import/json with entity: "customer") does not support assistance_allowed. Attempts to pass it as a field will result in a "Header contains invalid attribute(s): assistance_allowed" error. - -Alternatively, you can use `POST /V1/async/bulk/customers` to bulk create customers with assistance_allowed pre-enabled. - -```json -    { -      "customer": { -        "email": "user@example.com", -        "firstname": "User", -        "lastname": "One", -        "website_id": 1, -        "extension_attributes": {"assistance_allowed": 2} -      }, -      "password": "Password123!" -    } -``` - -Or individual existing customers using the `PUT /V1/customers/{id}` endpoint: - -```json -{"customer": {"extension_attributes": {"assistance_allowed": 2}}} -``` +In Adobe Commerce as a Cloud Service, the customer import API (POST /V1/import/json with entity: "customer") does not support `assistance_allowed`. + +If you need to create or modify customers that have [remote shopping assistance enabled](https://experienceleague.adobe.com/en/docs/commerce-admin/customers/customer-accounts/manage/login-as-customer#customer-account-permission-for-remote-shopping-assistance), you can: + +- Use `POST /V1/async/bulk/customers` to bulk create customers with assistance_allowed pre-enabled. + + ```json +     { +       "customer": { +         "email": "user@example.com", +         "firstname": "User", +         "lastname": "One", +         "website_id": 1, +         "extension_attributes": {"assistance_allowed": 2} +       }, +       "password": "Password123!" +     } + ``` + +- Use the `PUT /V1/customers/{id}` endpoint to modify existing customers individually. + + ```json + {"customer": {"extension_attributes": {"assistance_allowed": 2}}} + ``` ### Validation Strategy From 63e8f1100acdba9f47d5252b3d9b39e6b1643d6a Mon Sep 17 00:00:00 2001 From: Jared Hoover Date: Tue, 21 Apr 2026 18:02:47 -0500 Subject: [PATCH 03/12] linting --- src/pages/rest/modules/import/index.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/pages/rest/modules/import/index.md b/src/pages/rest/modules/import/index.md index 5c826e6e1..4d6142a69 100644 --- a/src/pages/rest/modules/import/index.md +++ b/src/pages/rest/modules/import/index.md @@ -54,7 +54,7 @@ In Adobe Commerce as a Cloud Service, the customer import API (POST /V1/import/j If you need to create or modify customers that have [remote shopping assistance enabled](https://experienceleague.adobe.com/en/docs/commerce-admin/customers/customer-accounts/manage/login-as-customer#customer-account-permission-for-remote-shopping-assistance), you can: -- Use `POST /V1/async/bulk/customers` to bulk create customers with assistance_allowed pre-enabled. +* Use `POST /V1/async/bulk/customers` to bulk create customers with assistance_allowed pre-enabled. ```json     { @@ -69,7 +69,7 @@ If you need to create or modify customers that have [remote shopping assistance     } ``` -- Use the `PUT /V1/customers/{id}` endpoint to modify existing customers individually. +* Use the `PUT /V1/customers/{id}` endpoint to modify existing customers individually. ```json {"customer": {"extension_attributes": {"assistance_allowed": 2}}} From fa7b5f77c5e00ad648f0ce9f28167e8012957fd5 Mon Sep 17 00:00:00 2001 From: Jared Hoover <98363870+jhadobe@users.noreply.github.com> Date: Mon, 27 Apr 2026 14:29:47 -0500 Subject: [PATCH 04/12] Apply suggestions from code review Co-authored-by: Kevin Harper --- src/pages/rest/modules/import/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/pages/rest/modules/import/index.md b/src/pages/rest/modules/import/index.md index 4d6142a69..75ec63e13 100644 --- a/src/pages/rest/modules/import/index.md +++ b/src/pages/rest/modules/import/index.md @@ -50,7 +50,7 @@ The `import/json` endpoint is designed for JSON data: #### Customer imports in Adobe Commerce as a Cloud Service -In Adobe Commerce as a Cloud Service, the customer import API (POST /V1/import/json with entity: "customer") does not support `assistance_allowed`. +In Adobe Commerce as a Cloud Service, the `POST /V1/import/json` endpoint does not support the `assistance_allowed` field when the `entity` field is set to `customer`. If you need to create or modify customers that have [remote shopping assistance enabled](https://experienceleague.adobe.com/en/docs/commerce-admin/customers/customer-accounts/manage/login-as-customer#customer-account-permission-for-remote-shopping-assistance), you can: From e32cd9b85beec6051035102297ce1019b9087ab8 Mon Sep 17 00:00:00 2001 From: Jared Hoover Date: Mon, 27 Apr 2026 14:34:52 -0500 Subject: [PATCH 05/12] code review --- src/pages/rest/modules/import/index.md | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/src/pages/rest/modules/import/index.md b/src/pages/rest/modules/import/index.md index 75ec63e13..0a59724f3 100644 --- a/src/pages/rest/modules/import/index.md +++ b/src/pages/rest/modules/import/index.md @@ -50,11 +50,9 @@ The `import/json` endpoint is designed for JSON data: #### Customer imports in Adobe Commerce as a Cloud Service -In Adobe Commerce as a Cloud Service, the `POST /V1/import/json` endpoint does not support the `assistance_allowed` field when the `entity` field is set to `customer`. +In Adobe Commerce as a Cloud Service, the `POST /V1/import/json` endpoint does not support the `assistance_allowed` field when the `entity` field is set to `customer`. However, you can create or modify customers that have [remote shopping assistance enabled](https://experienceleague.adobe.com/en/docs/commerce-admin/customers/customer-accounts/manage/login-as-customer#customer-account-permission-for-remote-shopping-assistance) by using the following methods: -If you need to create or modify customers that have [remote shopping assistance enabled](https://experienceleague.adobe.com/en/docs/commerce-admin/customers/customer-accounts/manage/login-as-customer#customer-account-permission-for-remote-shopping-assistance), you can: - -* Use `POST /V1/async/bulk/customers` to bulk create customers with assistance_allowed pre-enabled. +* Use `POST /V1/async/bulk/customers` to bulk create customers with `assistance_allowed` pre-enabled. ```json     { From 969630e03c61ef6599962165877ce2cc9e08b75d Mon Sep 17 00:00:00 2001 From: Jared Hoover Date: Mon, 27 Apr 2026 14:39:52 -0500 Subject: [PATCH 06/12] spacing --- src/pages/rest/modules/import/index.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/pages/rest/modules/import/index.md b/src/pages/rest/modules/import/index.md index 0a59724f3..8bb6b7de1 100644 --- a/src/pages/rest/modules/import/index.md +++ b/src/pages/rest/modules/import/index.md @@ -52,7 +52,7 @@ The `import/json` endpoint is designed for JSON data: In Adobe Commerce as a Cloud Service, the `POST /V1/import/json` endpoint does not support the `assistance_allowed` field when the `entity` field is set to `customer`. However, you can create or modify customers that have [remote shopping assistance enabled](https://experienceleague.adobe.com/en/docs/commerce-admin/customers/customer-accounts/manage/login-as-customer#customer-account-permission-for-remote-shopping-assistance) by using the following methods: -* Use `POST /V1/async/bulk/customers` to bulk create customers with `assistance_allowed` pre-enabled. +* Use `POST /V1/async/bulk/customers` to bulk create customers with `assistance_allowed` pre-enabled. ```json     { @@ -67,7 +67,7 @@ In Adobe Commerce as a Cloud Service, the `POST /V1/import/json` endpoint does n     } ``` -* Use the `PUT /V1/customers/{id}` endpoint to modify existing customers individually. +* Use the `PUT /V1/customers/{id}` endpoint to modify existing customers individually. ```json {"customer": {"extension_attributes": {"assistance_allowed": 2}}} From 3cfd24745fe0a1096899f8fa8df384c092efc901 Mon Sep 17 00:00:00 2001 From: Jared Hoover Date: Mon, 27 Apr 2026 14:42:03 -0500 Subject: [PATCH 07/12] remove breaking spaces --- src/pages/rest/modules/import/index.md | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/src/pages/rest/modules/import/index.md b/src/pages/rest/modules/import/index.md index 8bb6b7de1..14a97994d 100644 --- a/src/pages/rest/modules/import/index.md +++ b/src/pages/rest/modules/import/index.md @@ -55,16 +55,16 @@ In Adobe Commerce as a Cloud Service, the `POST /V1/import/json` endpoint does n * Use `POST /V1/async/bulk/customers` to bulk create customers with `assistance_allowed` pre-enabled. ```json -     { -       "customer": { -         "email": "user@example.com", -         "firstname": "User", -         "lastname": "One", -         "website_id": 1, -         "extension_attributes": {"assistance_allowed": 2} -       }, -       "password": "Password123!" -     } + { + "customer": { + "email": "user@example.com", + "firstname": "User", + "lastname": "One", + "website_id": 1, + "extension_attributes": {"assistance_allowed": 2} + }, + "password": "Password123!" + } ``` * Use the `PUT /V1/customers/{id}` endpoint to modify existing customers individually. From 8feac677869155d7f46ab6f5fed352b9e36b14e4 Mon Sep 17 00:00:00 2001 From: Jared Hoover Date: Mon, 27 Apr 2026 14:48:19 -0500 Subject: [PATCH 08/12] spacing --- src/pages/rest/modules/import/index.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/pages/rest/modules/import/index.md b/src/pages/rest/modules/import/index.md index 14a97994d..f411ff427 100644 --- a/src/pages/rest/modules/import/index.md +++ b/src/pages/rest/modules/import/index.md @@ -52,7 +52,7 @@ The `import/json` endpoint is designed for JSON data: In Adobe Commerce as a Cloud Service, the `POST /V1/import/json` endpoint does not support the `assistance_allowed` field when the `entity` field is set to `customer`. However, you can create or modify customers that have [remote shopping assistance enabled](https://experienceleague.adobe.com/en/docs/commerce-admin/customers/customer-accounts/manage/login-as-customer#customer-account-permission-for-remote-shopping-assistance) by using the following methods: -* Use `POST /V1/async/bulk/customers` to bulk create customers with `assistance_allowed` pre-enabled. +* Use `POST /V1/async/bulk/customers` to bulk create customers with `assistance_allowed` pre-enabled. ```json { @@ -67,7 +67,7 @@ In Adobe Commerce as a Cloud Service, the `POST /V1/import/json` endpoint does n } ``` -* Use the `PUT /V1/customers/{id}` endpoint to modify existing customers individually. +* Use the `PUT /V1/customers/{id}` endpoint to modify existing customers individually. ```json {"customer": {"extension_attributes": {"assistance_allowed": 2}}} From e6533113ec3c8c5d210145189c4ba8376009a249 Mon Sep 17 00:00:00 2001 From: Jared Hoover Date: Mon, 27 Apr 2026 15:06:32 -0500 Subject: [PATCH 09/12] test by removing indentation --- src/pages/rest/modules/import/index.md | 34 +++++++++++++------------- 1 file changed, 17 insertions(+), 17 deletions(-) diff --git a/src/pages/rest/modules/import/index.md b/src/pages/rest/modules/import/index.md index f411ff427..5c91e0270 100644 --- a/src/pages/rest/modules/import/index.md +++ b/src/pages/rest/modules/import/index.md @@ -52,26 +52,26 @@ The `import/json` endpoint is designed for JSON data: In Adobe Commerce as a Cloud Service, the `POST /V1/import/json` endpoint does not support the `assistance_allowed` field when the `entity` field is set to `customer`. However, you can create or modify customers that have [remote shopping assistance enabled](https://experienceleague.adobe.com/en/docs/commerce-admin/customers/customer-accounts/manage/login-as-customer#customer-account-permission-for-remote-shopping-assistance) by using the following methods: -* Use `POST /V1/async/bulk/customers` to bulk create customers with `assistance_allowed` pre-enabled. +Use `POST /V1/async/bulk/customers` to bulk create customers with `assistance_allowed` pre-enabled. - ```json - { - "customer": { - "email": "user@example.com", - "firstname": "User", - "lastname": "One", - "website_id": 1, - "extension_attributes": {"assistance_allowed": 2} - }, - "password": "Password123!" - } - ``` +```json + { + "customer": { + "email": "user@example.com", + "firstname": "User", + "lastname": "One", + "website_id": 1, + "extension_attributes": {"assistance_allowed": 2} + }, + "password": "Password123!" + } +``` -* Use the `PUT /V1/customers/{id}` endpoint to modify existing customers individually. +Use the `PUT /V1/customers/{id}` endpoint to modify existing customers individually. - ```json - {"customer": {"extension_attributes": {"assistance_allowed": 2}}} - ``` +```json +{"customer": {"extension_attributes": {"assistance_allowed": 2}}} +``` ### Validation Strategy From 60b1e647cdfa7ecc8a56355656b1498276378355 Mon Sep 17 00:00:00 2001 From: Jared Hoover Date: Mon, 27 Apr 2026 15:08:20 -0500 Subject: [PATCH 10/12] re add indentation and bullets --- src/pages/rest/modules/import/index.md | 34 +++++++++++++------------- 1 file changed, 17 insertions(+), 17 deletions(-) diff --git a/src/pages/rest/modules/import/index.md b/src/pages/rest/modules/import/index.md index 5c91e0270..f8fe084a6 100644 --- a/src/pages/rest/modules/import/index.md +++ b/src/pages/rest/modules/import/index.md @@ -52,26 +52,26 @@ The `import/json` endpoint is designed for JSON data: In Adobe Commerce as a Cloud Service, the `POST /V1/import/json` endpoint does not support the `assistance_allowed` field when the `entity` field is set to `customer`. However, you can create or modify customers that have [remote shopping assistance enabled](https://experienceleague.adobe.com/en/docs/commerce-admin/customers/customer-accounts/manage/login-as-customer#customer-account-permission-for-remote-shopping-assistance) by using the following methods: -Use `POST /V1/async/bulk/customers` to bulk create customers with `assistance_allowed` pre-enabled. +* Use `POST /V1/async/bulk/customers` to bulk create customers with `assistance_allowed` pre-enabled. -```json - { - "customer": { - "email": "user@example.com", - "firstname": "User", - "lastname": "One", - "website_id": 1, - "extension_attributes": {"assistance_allowed": 2} - }, - "password": "Password123!" - } -``` + ```json + { + "customer": { + "email": "user@example.com", + "firstname": "User", + "lastname": "Name", + "website_id": 1, + "extension_attributes": {"assistance_allowed": 2} + }, + "password": "Password123!" + } + ``` -Use the `PUT /V1/customers/{id}` endpoint to modify existing customers individually. +* Use the `PUT /V1/customers/{id}` endpoint to modify existing customers individually. -```json -{"customer": {"extension_attributes": {"assistance_allowed": 2}}} -``` + ```json + {"customer": {"extension_attributes": {"assistance_allowed": 2}}} + ``` ### Validation Strategy From ae630695878b66c2bd8eac657633e5420b2942ee Mon Sep 17 00:00:00 2001 From: Jared Hoover Date: Mon, 27 Apr 2026 15:10:56 -0500 Subject: [PATCH 11/12] try 2 spaces --- src/pages/rest/modules/import/index.md | 30 +++++++++++++------------- 1 file changed, 15 insertions(+), 15 deletions(-) diff --git a/src/pages/rest/modules/import/index.md b/src/pages/rest/modules/import/index.md index f8fe084a6..b6f387b50 100644 --- a/src/pages/rest/modules/import/index.md +++ b/src/pages/rest/modules/import/index.md @@ -54,24 +54,24 @@ In Adobe Commerce as a Cloud Service, the `POST /V1/import/json` endpoint does n * Use `POST /V1/async/bulk/customers` to bulk create customers with `assistance_allowed` pre-enabled. - ```json - { - "customer": { - "email": "user@example.com", - "firstname": "User", - "lastname": "Name", - "website_id": 1, - "extension_attributes": {"assistance_allowed": 2} - }, - "password": "Password123!" - } - ``` + ```json + { + "customer": { + "email": "user@example.com", + "firstname": "User", + "lastname": "Name", + "website_id": 1, + "extension_attributes": {"assistance_allowed": 2} + }, + "password": "Password123!" + } + ``` * Use the `PUT /V1/customers/{id}` endpoint to modify existing customers individually. - ```json - {"customer": {"extension_attributes": {"assistance_allowed": 2}}} - ``` + ```json + {"customer": {"extension_attributes": {"assistance_allowed": 2}}} + ``` ### Validation Strategy From bd72b2b95fcf158840bd193626785d56167c0674 Mon Sep 17 00:00:00 2001 From: Jared Hoover Date: Mon, 27 Apr 2026 15:20:18 -0500 Subject: [PATCH 12/12] spacing and prettify --- src/pages/rest/modules/import/index.md | 32 ++++++++++++++------------ 1 file changed, 17 insertions(+), 15 deletions(-) diff --git a/src/pages/rest/modules/import/index.md b/src/pages/rest/modules/import/index.md index b6f387b50..0f27996e9 100644 --- a/src/pages/rest/modules/import/index.md +++ b/src/pages/rest/modules/import/index.md @@ -54,24 +54,26 @@ In Adobe Commerce as a Cloud Service, the `POST /V1/import/json` endpoint does n * Use `POST /V1/async/bulk/customers` to bulk create customers with `assistance_allowed` pre-enabled. - ```json - { - "customer": { - "email": "user@example.com", - "firstname": "User", - "lastname": "Name", - "website_id": 1, - "extension_attributes": {"assistance_allowed": 2} - }, - "password": "Password123!" - } - ``` + ```json + { + "customer": { + "email": "user@example.com", + "firstname": "User", + "lastname": "Name", + "website_id": 1, + "extension_attributes": { + "assistance_allowed": 2 + } + }, + "password": "Password123!" + } + ``` * Use the `PUT /V1/customers/{id}` endpoint to modify existing customers individually. - ```json - {"customer": {"extension_attributes": {"assistance_allowed": 2}}} - ``` + ```json + {"customer": {"extension_attributes": {"assistance_allowed": 2}}} + ``` ### Validation Strategy