diff --git a/docs/guides/troubleshooting.md b/docs/guides/troubleshooting.md
index 1979aad5f3..bb2e79d071 100644
--- a/docs/guides/troubleshooting.md
+++ b/docs/guides/troubleshooting.md
@@ -203,3 +203,12 @@ provider "databricks" {
 ```
 
 The above would enforce the use of PAT authorization.
+
+
+### oauth-m2m: oidc: databricks OAuth is not supported for this host.
+
+There could be different reasons for this error:
+
+- Old version of Terraform provider is used - there were [problems reported](https://github.com/databricks/terraform-provider-databricks/issues/3023) with versions lower than 1.35.0, so try to upgrade your provider.
+- You use multiple provider instances in your code and don't specify that specific instance in your resource or data source - in this case, Terraform will try to use "default instance" that could be initialized from the `DEFAULT` profile in your `~/.databrickscfg` file if you have it.  Check that correct provider instance is used everywhere.
+- If you're using authentication data from `~/.databrickscfg` file, check that profile you're using has correct data - URL, client ID and secret.