{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Greenhouse Identity Configuration Guide","siteUrl":"https://docs.synqly.com","lang":"en-US","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This guide walks you through the steps to gather the necessary information and configure your Greenhouse Recruiting organization for the purpose of creating an integration."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prerequisites","__idx":0},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before you begin, ensure that you have:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Access to the Greenhouse Recruiting web interface"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Access to a Greenhouse Recruiting account with permission to manage all of the organization's API credentials"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"required-permissions","__idx":1},"children":["Required Permissions"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Harvest v3 Permission"},"children":["Harvest v3 Permission"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Purpose"},"children":["Purpose"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Users"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read data about users, activate users, and deactivate users"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"generating-credentials","__idx":2},"children":["Generating Credentials"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Log in to Greenhouse."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Configure > Dev Center > API Credential Management"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create new API credentials"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API type"]},", choose ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Harvest V3 (OAuth)"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Choose the appropriate partner or select a custom/unlisted integration, depending on your Greenhouse setup."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter a description that identifies the Synqly integration."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Save the credential."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Copy the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client ID"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client Secret"]}," and store them securely."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open the credential's permissions or scopes settings and grant access according to the required permissions above."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Save the credential permissions."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"optional-user-id","__idx":3},"children":["Optional User ID"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Leave ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["User ID"]}," blank unless Greenhouse must treat the API calls as a specific human user."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Leave blank (default):"]}," almost always. The Harvest v3 integration service user can read users and enable or disable them if it has the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Users"]}," permission."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Set it:"]}," when Greenhouse must audit or authorize the calls as a specific person (compliance, “who disabled this user”, or the integration service user lacks access that a Site Admin has)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Effect:"]}," API requests are attributed to that Greenhouse user. An invalid User ID fails Verify on ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["User ID"]},", not on URL."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["How to get it:"]}," open the user in Greenhouse and copy the numeric ID or the full URL (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://app.greenhouse.io/account/users/12345"]},"). Both are accepted."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"configure-the-integration","__idx":4},"children":["Configure the Integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Create your integration by supplying the following configuration values."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Integration Parameter"},"children":["Integration Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Client ID"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["This is the Client ID generated from the steps above."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Client Secret"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["This is the Client Secret generated from the steps above."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["User ID"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional. Leave blank to use the credential's integration service user. Set it only if API requests must be attributed to a specific Greenhouse user."]}]}]}]}]}]},"headings":[{"value":"Prerequisites","id":"prerequisites","depth":2},{"value":"Required Permissions","id":"required-permissions","depth":2},{"value":"Generating Credentials","id":"generating-credentials","depth":2},{"value":"Optional User ID","id":"optional-user-id","depth":2},{"value":"Configure the Integration","id":"configure-the-integration","depth":2}],"frontmatter":{"slug":"guides/provider-configuration/greenhouse-identity-setup","seo":{"title":"Greenhouse Identity Configuration Guide"}},"lastModified":"2026-09-07T22:20:21.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/provider-configuration/greenhouse-identity-setup","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}