diff --git a/app/controllers/api/users.php b/app/controllers/api/users.php
index 7043c64534..6a109ee5c7 100644
--- a/app/controllers/api/users.php
+++ b/app/controllers/api/users.php
@@ -1433,7 +1433,7 @@ App::post('/v1/users/:userId/sessions')
     ->label('sdk.auth', [APP_AUTH_TYPE_KEY])
     ->label('sdk.namespace', 'users')
     ->label('sdk.method', 'createSession')
-    ->label('sdk.description', '/docs/references/users/create-user-session.md')
+    ->label('sdk.description', '/docs/references/users/create-session.md')
     ->label('sdk.response.code', Response::STATUS_CODE_CREATED)
     ->label('sdk.response.type', Response::CONTENT_TYPE_JSON)
     ->label('sdk.response.model', Response::MODEL_SESSION)
diff --git a/docs/references/users/create-session.md b/docs/references/users/create-session.md
new file mode 100644
index 0000000000..330a88de74
--- /dev/null
+++ b/docs/references/users/create-session.md
@@ -0,0 +1,3 @@
+Creates a session for a user. Returns an immediately usable session object.
+
+If you want to generate a token for a custom authentication flow, use the [POST /users/{userId}/tokens](https://appwrite.io/docs/server/users#createToken) endpoint.
\ No newline at end of file