diff --git a/app/controllers/api/account.php b/app/controllers/api/account.php
index d66c3be806..e05bdbe883 100644
--- a/app/controllers/api/account.php
+++ b/app/controllers/api/account.php
@@ -313,7 +313,7 @@ App::get('/v1/account/sessions/oauth2/:provider')
     ->label('sdk.auth', [])
     ->label('sdk.namespace', 'account')
     ->label('sdk.method', 'createOAuth2Session')
-    ->label('sdk.description', '/docs/references/account/create-session-oauth2.md')
+    ->label('sdk.description', '/docs/references/account/create-oauth2-session.md')
     ->label('sdk.response.code', Response::STATUS_CODE_MOVED_PERMANENTLY)
     ->label('sdk.response.type', Response::CONTENT_TYPE_HTML)
     ->label('sdk.methodType', 'webAuth')
diff --git a/docs/references/account/create-session-oauth2.md b/docs/references/account/create-oauth2-session.md
similarity index 100%
rename from docs/references/account/create-session-oauth2.md
rename to docs/references/account/create-oauth2-session.md
diff --git a/docs/references/account/create-session.md b/docs/references/account/create-session.md
index d469ee1bee..a00c10667c 100644
--- a/docs/references/account/create-session.md
+++ b/docs/references/account/create-session.md
@@ -1 +1 @@
-Use this endpoint to complete creating the session with a custom session token. Both the **userId** and **secret** arguments will be returned in the response body when sending your request to the [POST /users/:userId/sessions](https://appwrite.io/docs/references/cloud/server-nodejs/users#createToken) endpoint.
+Use this endpoint to create a session from token. Provide the **userId** and **secret** parameters from the successful response of authentication flows initiated by token creation. For example, magic URL and phone login.
\ No newline at end of file