diff --git a/docs/b2b-edition/specs/api-v3/user/user.yaml b/docs/b2b-edition/specs/api-v3/user/user.yaml
index 26afb5c08..69a7b3742 100644
--- a/docs/b2b-edition/specs/api-v3/user/user.yaml
+++ b/docs/b2b-edition/specs/api-v3/user/user.yaml
@@ -162,7 +162,7 @@ paths:
     post:
       summary: Create A Company User
       description: |-
-        Create a Company user within an existing Company.
+        Create a Company user within an existing Company. This migrates the user's existing orders to the Company's Buyer Portal if their email address is associated with a B2C customer account.
 
         With [Independent Company behavior](/b2b-edition/apis/rest-management/company/companies#independent-vs-dependent-companies-behavior) enabled, B2B Edition Company accounts are the source of truth for defining a Company user’s customer group assignment.
         
diff --git a/docs/b2b-edition/specs/storefront/storefront/company.yaml b/docs/b2b-edition/specs/storefront/storefront/company.yaml
index 499b25c8b..933f240f4 100644
--- a/docs/b2b-edition/specs/storefront/storefront/company.yaml
+++ b/docs/b2b-edition/specs/storefront/storefront/company.yaml
@@ -1134,6 +1134,10 @@ paths:
         This endpoint will send a welcome email to the new user as if they had created their account via the Storefront UI.
 
         When you create an account this way, the user must reset their password to log in to the storefront unless they already have an existing BigCommerce customer account.
+
+        > Using this endpoint or the equivalent GraphQL API mutation to create a new user from an existing BigCommerce customer account **does not** allow the user to access their previous orders from the Company's Buyer Portal.
+        > 
+        > Use the [Assign Customer Orders to Company](/b2b-edition/apis/rest-management/order/orders#assign-customer-orders-to-company) endpoint to migrate their orders after account creation, or create Company users via the [Users REST Management API](/b2b-edition/apis/rest-management/user/users#create-a-company-user) to automaticalyl migrate their orders.
       parameters: []
       requestBody:
         content: