diff --git a/apps/docs/docs/editor/blocks/integrations/openai.mdx b/apps/docs/docs/editor/blocks/integrations/openai.mdx
index c1c1695fceb..5b53275ee7b 100644
--- a/apps/docs/docs/editor/blocks/integrations/openai.mdx
+++ b/apps/docs/docs/editor/blocks/integrations/openai.mdx
@@ -23,3 +23,13 @@ Under the hood, **Messages sequence ✨** will convert the provided variables in
 :::
 
 <YoutubeEmbed videoId="v167drfHFzk" />
+
+## Troobleshooting
+
+### Error message: "OpenAI block returned error"
+
+It means your OpenAI block is not configured properly. Please check the following:
+
+- You have selected an OpenAI account
+- You have at least 1 **user** message or a **Message sequence ✨**.
+- If you have a **Message sequence ✨**, make sure your user messages variable contains at least 1 message.