diff --git a/docs-site/docs/features/reactive-resume.md b/docs-site/docs/features/reactive-resume.md
index dfe8e41..4ba8fd2 100644
--- a/docs-site/docs/features/reactive-resume.md
+++ b/docs-site/docs/features/reactive-resume.md
@@ -74,6 +74,16 @@ At generation time:
 
 ## Setup and configuration
 
+### Account requirements (important)
+
+Before connecting Reactive Resume to JobOps:
+
+1. Create your account on **RxResume v4** at [v4.rxresu.me/auth/register](https://v4.rxresu.me/auth/register).
+2. Use a **native email + password** account (not Google/GitHub/other OAuth login).
+3. Generate/store that password so JobOps can use it for API login.
+
+JobOps cannot use OAuth-based RxResume logins for this integration.
+
 ### 1) Configure RxResume credentials
 
 Configure in Settings:
@@ -171,7 +181,8 @@ curl -X POST "http://localhost:3001/api/jobs/<jobId>/generate-pdf"
 
 ### No resumes appear in dropdown
 
-- Confirm credentials are valid for `rxresu.me`/your configured RxResume URL.
+- Confirm credentials are valid for [v4.rxresu.me](https://v4.rxresu.me)/your configured RxResume URL.
+- Confirm the RxResume account is a native email/password account (not OAuth-only).
 - Confirm the selected RxResume account actually has resumes.
 
 ### Project list is empty in settings
diff --git a/docs-site/versioned_docs/version-0.1.21/features/reactive-resume.md b/docs-site/versioned_docs/version-0.1.21/features/reactive-resume.md
index dfe8e41..4ba8fd2 100644
--- a/docs-site/versioned_docs/version-0.1.21/features/reactive-resume.md
+++ b/docs-site/versioned_docs/version-0.1.21/features/reactive-resume.md
@@ -74,6 +74,16 @@ At generation time:
 
 ## Setup and configuration
 
+### Account requirements (important)
+
+Before connecting Reactive Resume to JobOps:
+
+1. Create your account on **RxResume v4** at [v4.rxresu.me/auth/register](https://v4.rxresu.me/auth/register).
+2. Use a **native email + password** account (not Google/GitHub/other OAuth login).
+3. Generate/store that password so JobOps can use it for API login.
+
+JobOps cannot use OAuth-based RxResume logins for this integration.
+
 ### 1) Configure RxResume credentials
 
 Configure in Settings:
@@ -171,7 +181,8 @@ curl -X POST "http://localhost:3001/api/jobs/<jobId>/generate-pdf"
 
 ### No resumes appear in dropdown
 
-- Confirm credentials are valid for `rxresu.me`/your configured RxResume URL.
+- Confirm credentials are valid for [v4.rxresu.me](https://v4.rxresu.me)/your configured RxResume URL.
+- Confirm the RxResume account is a native email/password account (not OAuth-only).
 - Confirm the selected RxResume account actually has resumes.
 
 ### Project list is empty in settings
diff --git a/orchestrator/src/client/components/OnboardingGate.tsx b/orchestrator/src/client/components/OnboardingGate.tsx
index a40066d..7edd77e 100644
--- a/orchestrator/src/client/components/OnboardingGate.tsx
+++ b/orchestrator/src/client/components/OnboardingGate.tsx
@@ -664,7 +664,16 @@ export const OnboardingGate: React.FC = () => {
                   Link your RxResume account
                 </p>
                 <p className="text-xs text-muted-foreground">
-                  Used to export tailored PDFs.
+                  Used to export tailored PDFs. Create an account{" "}
+                  <a
+                    className="underline underline-offset-2"
+                    href="https://v4.rxresu.me/auth/register"
+                    target="_blank"
+                    rel="noreferrer"
+                  >
+                    here
+                  </a>{" "}
+                  on RxResume v4 using email/password.
                 </p>
               </div>
               <div className="grid gap-4 md:grid-cols-2">