diff --git a/docs/hub/oauth.md b/docs/hub/oauth.md
index 90a48866e..1b22119b5 100644
--- a/docs/hub/oauth.md
+++ b/docs/hub/oauth.md
@@ -35,6 +35,7 @@ The currently supported scopes are:
 - `write-repos`: Get write/read access to the user's personal repos.
 - `manage-repos`: Get full access to the user's personal repos. Also grants repo creation and deletion.
 - `inference-api`: Get access to the [Inference API](https://huggingface.co/docs/api-inference/index), you will be able to make inference requests on behalf of the user.
+- `write-discussions`: Open discussions and Pull Requests on behalf of the user as well as interact with discussions (including reactions, posting/editing comments, closing discussions, ...).
 
 All other information is available in the [OpenID metadata](https://huggingface.co/.well-known/openid-configuration).
 
diff --git a/docs/hub/spaces-oauth.md b/docs/hub/spaces-oauth.md
index 8bfde571f..745709f9e 100644
--- a/docs/hub/spaces-oauth.md
+++ b/docs/hub/spaces-oauth.md
@@ -76,6 +76,7 @@ Those scopes are optional and can be added by setting `hf_oauth_scopes` in your
 - `write-repos`: Get write/read access to the user's personal repos.
 - `manage-repos`: Get full access to the user's personal repos. Also grants repo creation and deletion.
 - `inference-api`: Get access to the [Inference API](https://huggingface.co/docs/api-inference/index), you will be able to make inference requests on behalf of the user.
+- `write-discussions`: Open discussions and Pull Requests on behalf of the user as well as interact with discussions (including reactions, posting/editing comments, closing discussions, ...).
 
 ## Adding the button to your Space