docs(greenhouse): switch IAM guide to Harvest V3 OAuth credentials

connection-guides/iam/greenhouse.mdx

@@ -5,71 +5,82 @@ description: "If you have been directed to StackOne to integrate with Greenhouse
 
 
 <Warning>
-  This guidance assumes you have Admin privileges for your Greenhouse account.
+  This guidance assumes you have Admin privileges for your Greenhouse account, including the "Can manage ALL organization's API Credentials" permission.
 </Warning>
 
+Greenhouse is retiring the Harvest v1 and v2 API keys. The StackOne integration now connects using Harvest V3 OAuth credentials, a Client ID and Client Secret you generate in the Greenhouse Dev Center, instead of a single API key.
 
-## Generating Harvest API Key
+If you already have a Greenhouse account connected to StackOne, you don't need to disconnect and set up a new one. Reconnect that same account with your new Harvest V3 credentials. Your account ID and everything you've already configured stay exactly as they are, and your existing syncs keep running once you've reconnected.
 
-<Steps>
-  <Step title="Open the Configuration Page">
-    Click on Configure gear ⚙️ and open Dev Center > API credentials.
-    ​
-    <Frame>
-      ![Step 1](/images/greenhouse/image1.png)   
-    </Frame>
-  </Step>
-  <Step title="Create a New API Key">
-    Click Create new API key. Specify the following parameters:
+## Create Harvest V3 OAuth credentials
 
-    API type – Harvest
-
-    Partner – Custom
+<Steps>
+  <Step title="Open API Credential Management">
+    Click the **Configure** icon on the navigation bar, click **Dev Center** on the left menu, then click **API Credential Management**.
 
-    Description – "Describe_your_integration"
-    ​
     <Frame>
-      ![Step 2](/images/greenhouse/image2.png) 
+      <img className='rounded-md' style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Open API Credential Management in the Greenhouse Dev Center" src="/images/greenhouse/image1.png" />
     </Frame>
   </Step>
-  <Step title="Generate and Save the API Key">
-    Click Manage permissions.
 
-    Copy your newly generated API key to a safe place. Then click **I have stored the API key**.
+  <Step title="Create new API credentials">
+    Click **Create new API credentials**, select **Harvest V3 (OAuth)** as the API type, and enter a description, for example "StackOne Integration".
+  </Step>
 
-    <Frame>
-      ![Step 3](/images/greenhouse/image3.png)
-    </Frame>
+  <Step title="Copy your Client ID and Client Secret">
+    Copy both the **Client ID** and the **Client Secret** and store them somewhere safe before you close the dialog. Greenhouse shows the Client Secret only once. If you lose it, you'll need to create a new credential.
   </Step>
-  <Step title="Enabling Permissions">
-    In the Manage permissions page, enable Select the following 2 permissions and click **Save**:
 
-    - User Roles
-    - Users
-    ​
-    <Frame>
-      ![Step 4](/images/greenhouse/image6.png)
-    </Frame>
+  <Step title="Configure the scopes">
+    Open the **Settings** tab of your new credentials. Under **Manage Scopes**, click the **Harvest** dropdown and enable the scopes StackOne needs to read your users and their roles:
+    - `harvest:users:list`
+    - `harvest:user_roles:list`
   </Step>
 </Steps>
 
-## Retrieve your Greenhouse User ID
-Per the Greenhouse documentation, you can locate a User ID by going to the **Users** page, select a User with the **Site Admin** permission and retrieve the User ID present in the URL:
+## Find your User ID (optional)
 
-*Screenshot of an example User ID:*
+StackOne can act on behalf of a specific Greenhouse user when it calls the API. To set this up, go to **Configure > Users**, click the user, and copy the numeric ID from the browser URL. For example, `https://app.greenhouse.io/account/users/12345678/edit` gives you the ID `12345678`.
 
 <Frame>
-![Step 6](/images/greenhouse/10577285508763.png)
+  <img className='rounded-md' style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Greenhouse user ID shown in the profile URL" src="/images/greenhouse/10577285508763.png" />
 </Frame>
 
+To find your own User ID, locate your account in the list (marked **"(you)"**), click **Export to Excel**, and read your ID from the **User ID** column.
+
+The user you choose needs Site Admin permissions. Greenhouse only lets Site Admins list users, so a User ID that isn't a Site Admin will cause user listing to fail.
+
+If you leave this field blank, StackOne acts as the auto-generated service account attached to your credentials instead of a specific user.
+
 ## Connect with StackOne
-Enter the gathered details in the relevant inputs and proceed by clicking the Connect button.
 
-<Frame>
-![Step 7](/images/greenhouse/image7.png)
-</Frame>
+If this is your first time connecting Greenhouse to StackOne, go to **Accounts > Link Account > Greenhouse** and enter:
+
+- **Client ID**
+- **Client Secret**
+- **User ID** (optional)
+
+Then click **Connect**.
 
+## Reconnect your existing account
+
+If you already have a Greenhouse account connected, reconnect it instead of creating a new one.
+
+<Steps>
+  <Step title="Open the account in the StackOne Hub">
+    Go to **Accounts** in the StackOne Hub and find your existing Greenhouse account.
+  </Step>
+
+  <Step title="Start the reconnect flow">
+    Select **Reconnect** on that account. This may be labelled **Edit connection**.
+  </Step>
+
+  <Step title="Enter your new credentials">
+    Enter the **Client ID** and **Client Secret** you copied earlier, plus the **User ID** if you're using one, then save.
+  </Step>
+</Steps>
 
+Reconnecting keeps the same account ID and every setting you already had configured. Your syncs keep running once the new credentials are saved, so there is nothing else to redo.
 
 ## Available data
 
@@ -81,6 +92,6 @@ This integration has the following [IAM Resources](https://docs.stackone.com/ref
 
 
 ## Useful Links
-<Card title="API Reference" icon="link" href="https://developers.greenhouse.io/harvest.html">
-    https://developers.greenhouse.io/harvest.html
+<Card title="API Reference" icon="link" href="https://harvestdocs.greenhouse.io/docs/authentication">
+    https://harvestdocs.greenhouse.io/docs/authentication
 </Card>