From d8e6bbe938524acbb3a6888136ddd3c3ba81acd4 Mon Sep 17 00:00:00 2001 From: Jared Hoover Date: Tue, 21 Apr 2026 17:28:57 -0500 Subject: [PATCH 1/3] 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 2/3] 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 3/3] 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}}}