diff --git a/README.md b/README.md
index ad221ff..cc7bc53 100644
--- a/README.md
+++ b/README.md
@@ -59,14 +59,18 @@ Note that all usernames are unique in the system : many users can't have the sam
 
 For AuthN, the app exposes the following [gRPC](https://grpc.io/) services :
 
--   **Create** : create an auth with one username / password (you can't create multiple usernames at once)
+-   **Create** : create an auth with usernames and a password
 
     ```json
     {
-        "uuid": "30f49838-3f24-42bb-a489-8ffb480173ae",
-        "username": "john.doe@email.com",
-        "password": "John123",
-        "type": "EMAIL"
+        "userId": "30f49838-3f24-42bb-a489-8ffb480173ae",
+        "usernames": [
+            {
+                "name": "john.doe@email.com",
+                "type": "EMAIL"
+            }
+        ],
+        "password": "John123"
     }
     ```
 
@@ -74,8 +78,8 @@ For AuthN, the app exposes the following [gRPC](https://grpc.io/) services :
 
     ```json
     {
-        "uuid": "30f49838-3f24-42bb-a489-8ffb480173ae",
-        "username": "+33611223344",
+        "userId": "30f49838-3f24-42bb-a489-8ffb480173ae",
+        "name": "+33611223344",
         "type": "PHONE"
     }
     ```
@@ -84,8 +88,8 @@ For AuthN, the app exposes the following [gRPC](https://grpc.io/) services :
 
     ```json
     {
-        "uuid": "30f49838-3f24-42bb-a489-8ffb480173ae",
-        "username": "johnny.doe@email.com",
+        "userId": "30f49838-3f24-42bb-a489-8ffb480173ae",
+        "name": "johnny.doe@email.com",
         "type": "EMAIL"
     }
     ```
@@ -94,7 +98,7 @@ For AuthN, the app exposes the following [gRPC](https://grpc.io/) services :
 
     ```json
     {
-        "username": "+33611223344"
+        "name": "+33611223344"
     }
     ```
 
@@ -102,16 +106,16 @@ For AuthN, the app exposes the following [gRPC](https://grpc.io/) services :
 
     ```json
     {
-        "uuid": "30f49838-3f24-42bb-a489-8ffb480173ae",
+        "userId": "30f49838-3f24-42bb-a489-8ffb480173ae",
         "password": "Johnny123"
     }
     ```
 
--   **Validate** : validate an auth (= authentication with username/password)
+-   **Validate** : validate an auth (= authentication with name/password)
 
     ```json
     {
-        "username": "john.doe@email.com",
+        "name": "john.doe@email.com",
         "password": "Johnny123"
     }
     ```
@@ -120,7 +124,7 @@ For AuthN, the app exposes the following [gRPC](https://grpc.io/) services :
 
     ```json
     {
-        "uuid": "30f49838-3f24-42bb-a489-8ffb480173ae"
+        "userId": "30f49838-3f24-42bb-a489-8ffb480173ae"
     }
     ```
 
@@ -134,7 +138,7 @@ For AuthZ, the app exposes the following [gRPC](https://grpc.io/) services :
 
     ```json
     {
-        "uuid": "96d99d44-e0a6-458e-a656-de2a400d60a9",
+        "userId": "96d99d44-e0a6-458e-a656-de2a400d60a9",
         "domain": "USER",
         "action": "READ",
         "context": [