diff --git a/API_DESIGN.md b/API_DESIGN.md
index 7df13d6588..ea37df5a24 100644
--- a/API_DESIGN.md
+++ b/API_DESIGN.md
@@ -56,6 +56,10 @@ Provide clear and concise documentation for the API.
 Do not rely on implicit fallbacks or defaults if the client does not provide certain parameters.
 Only use defaults if they are explicitly documented, such as returning a result set for the whole instance if no filter is provided.
 
+Some API calls may create multiple resources such as in the case of `zitadel.org.v2.AddOrganization`, where you can create an organization AND multiple users as admin.
+In such cases the response should include **ALL** created resources and their ids. This removes any ambiguity from the users perspective whether or not
+the additional resources were created and it also helps in testing.
+
 ### Naming Conventions
 
 Names of resources, fields and methods MUST be descriptive and consistent.
@@ -371,4 +375,4 @@ message VerifyEmailRequest{
   ];
 }
 
-```
\ No newline at end of file
+```