diff --git a/docs/references/account/update-custom-session.md b/docs/references/account/update-custom-session.md
index 3d806c4057..319cd651ae 100644
--- a/docs/references/account/update-custom-session.md
+++ b/docs/references/account/update-custom-session.md
@@ -1 +1 @@
-Use this endpoint to exchange a previously generated token for a session. The returned session will be a regular session object with all its own credentials and metadata.
\ No newline at end of file
+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#createCustomSession) endpoint.
diff --git a/docs/references/users/create-custom-session.md b/docs/references/users/create-custom-session.md
index c443cdd572..47eae7a39b 100644
--- a/docs/references/users/create-custom-session.md
+++ b/docs/references/users/create-custom-session.md
@@ -1 +1 @@
-Use this endpoint to generate a 'universal' token which can be sent to a user by a secure method, and then exchanged for a session.
\ No newline at end of file
+Returns a custom token with a secret key for creating a session. If the provided user ID has not be registered, a new user will be created. Use the returned user ID and secret and submit a request to the [PUT /account/sessions/custom](https://appwrite.io/docs/references/cloud/client-web/account#updateCustomSession) endpoint to complete the login process. By default, the secret sent in the response is valid for 15 minutes.
\ No newline at end of file