From 386426bdd61973f29bd2ccfcc0c58b5d8271528e Mon Sep 17 00:00:00 2001
From: lelia <2418071+lelia@users.noreply.github.com>
Date: Fri, 26 Jun 2026 17:09:47 -0400
Subject: [PATCH] fix: warn when socket_org is missing

Warn when scan results cannot be uploaded because socket_org is unavailable after API key configuration.
---
 socket_basics/socket_basics.py | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/socket_basics/socket_basics.py b/socket_basics/socket_basics.py
index 72214af..bfedbe1 100644
--- a/socket_basics/socket_basics.py
+++ b/socket_basics/socket_basics.py
@@ -229,7 +229,12 @@ def submit_socket_facts(self, socket_facts_path: Path, results: Dict[str, Any])
                 
             socket_org = self.config.get('socket_org')
             if not socket_org:
-                logger.debug("No Socket organization configured, skipping full scan submission")
+                logger.warning(
+                    "No Socket organization configured - scan results will not be uploaded to the dashboard. "
+                    "This typically means your API key is missing the 'socket-basics:read' scope. "
+                    "Please create an API key with the required scopes in Settings > API Tokens "
+                    "in the Socket dashboard (https://socket.dev)."
+                )
                 return results
                 
             # Import socketdev SDK