diff --git a/reference/catalog/products_catalog.v3.yml b/reference/catalog/products_catalog.v3.yml
index 506996462..d7cb24753 100644
--- a/reference/catalog/products_catalog.v3.yml
+++ b/reference/catalog/products_catalog.v3.yml
@@ -4683,7 +4683,12 @@ paths:
                     $ref: '#/components/schemas/MetaPaginationObject'
     put:
       summary: Create Products Channel Assignments
-      description: Creates products channel assignments.
+      description: |
+        Creates products channel assignments.
+
+        Notes:
+         * Avoid parallel assignment requests if possible.
+         * Do not make parallel assignment requests with the same product IDs.
       operationId: createProductsChannelAssignments
       parameters:
         - $ref: '#/components/parameters/ContentType'