diff --git a/connection-guides/iam/greenhouse.mdx b/connection-guides/iam/greenhouse.mdx
index 6214c97..f974af1 100644
--- a/connection-guides/iam/greenhouse.mdx
+++ b/connection-guides/iam/greenhouse.mdx
@@ -5,71 +5,60 @@ description: "If you have been directed to StackOne to integrate with Greenhouse
- 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.
+Greenhouse is retiring the Harvest v1 and v2 API keys on August 31, 2026. 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
+## Create Harvest V3 OAuth credentials
-
- Click on Configure gear ⚙️ and open Dev Center > API credentials.
-
-
- 
-
-
-
- Click Create new API key. Specify the following parameters:
-
- API type – Harvest
+
+ Click the **Configure** icon on the navigation bar, click **Dev Center** on the left menu, then click **API Credential Management**.
- Partner – Custom
-
- Description – "Describe_your_integration"
-
- 
+ 
-
- Click Manage permissions.
- Copy your newly generated API key to a safe place. Then click **I have stored the API key**.
+
+ Click **Create new API credentials**, select **Harvest V3 (OAuth)** as the API type, and enter a description, for example "StackOne Integration".
+
-
- 
-
+
+ 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.
-
- In the Manage permissions page, enable Select the following 2 permissions and click **Save**:
- - User Roles
- - Users
-
-
- 
-
+
+ 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`
-## 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`.
-
+ 
+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.
-
-
-
+To connect or reconnect your Greenhouse account, enter:
+- **Client ID**
+- **Client Secret**
+- **User ID** (optional)
+Then click **Connect**.
## Available data
@@ -81,6 +70,6 @@ This integration has the following [IAM Resources](https://docs.stackone.com/ref
## Useful Links
-
- https://developers.greenhouse.io/harvest.html
+
+ https://harvestdocs.greenhouse.io/docs/authentication