Authorization
Connect your Greenhouse account to Okta Workflows using OAuth.
About this task
When you add a Greenhouse card to a flow for the first time, Okta Workflows prompts you to configure the connection. This connection links to your Greenhouse account and saves your account information, so you can reuse the connection for future Greenhouse flows.
Note:
You can create multiple unique connections and manage them from the Connections page in the Okta Workflows Console.
Before you begin
-
Okta Workflows administrator authority
To create a connection in Okta Workflows:
- Open the Connections tab in the Workflows Console or open a Greenhouse card.
- Select New Connection.
- Enter a connection Name. A unique name is useful if you plan to create multiple connections to share with your team.
- Enter a connection Description. This is useful to have more information regarding your connection.
- Select Create.
- A popup window opens on the Greenhouse authorization page, listing the supported scopes. Enter your Email and select Log in to Greenhouse.
- If prompted, sign in with your Greenhouse account credentials.
- A consent window appears, listing the supported scopes. Optionally, select the Authorize using a service account checkbox.
- Select Authorize.
- You're redirected back and the connection is created.
CAUTION: If a Greenhouse connection isn't used for more than 24 hours, it becomes inactive, and you must reauthorize it before you can use it again. Set up a scheduled flow that runs at least once every 24 hours to keep the connection active.
The Greenhouse connector supports the following OAuth scopes:
-
Update candidates -
Create user emails -
Update users -
List applications -
List attachments -
List candidates -
List custom field options -
List custom fields -
List users
CAUTION: If you revoke the access token without removing the connection from Okta Workflows, the card might continue running and encounter an OAuth refresh error with a 500 response code.