From 3316ebe266c60d0d54ca95d1453cb96e7703c731 Mon Sep 17 00:00:00 2001 From: Sasha Kluger Date: Thu, 28 Sep 2023 09:28:37 +0800 Subject: [PATCH] Update Greenhouse.md Add Greenhouse integration help doc. --- .../HR-integrations/Greenhouse.md | 44 +++++++++++++++++-- 1 file changed, 41 insertions(+), 3 deletions(-) diff --git a/docs/articles/expensify-classic/integrations/HR-integrations/Greenhouse.md b/docs/articles/expensify-classic/integrations/HR-integrations/Greenhouse.md index 3ee1c8656b4b..b44e5a090d17 100644 --- a/docs/articles/expensify-classic/integrations/HR-integrations/Greenhouse.md +++ b/docs/articles/expensify-classic/integrations/HR-integrations/Greenhouse.md @@ -1,5 +1,43 @@ --- -title: Coming Soon -description: Coming Soon +title: Greenhouse Integration +description: Automatically send candidates from Greenhouse to Expensify for easy reimbursement --- -## Resource Coming Soon! + +# Overview +Expensify's direct integration with Greenhouse allows you to automatically send candidates from Greenhouse to Expensify for easy reimbursement. The integration can set the candidate's recruiter or recruiting coordinator as approver in Expensify. + +## Prerequisites of the integration +- You must be a Workspace Admin in Expensify and an Admin in Greenhouse with Developer Permissions to complete this connection. This can be the same person or two different people. +- Each Greenhouse candidate record must have an email address in order to send to Expensify since we use this as the unique identifier in Expensify. +- We highly recommend that you create a specific Expensify workspace for candidates so that you can set up a separate workflow and a different set of Categories and Tags from what your employees would see. + +# How to connect Greenhouse to Expensify +## Establish the connection from Expensify + +1. Log into Expensify as a Workspace admin and navigate to **Settings > Workspaces > _[Workspace Name]_ > Connections** +2. Under Greenhouse, click **Connect to Greenhouse** then click **Sync with Greenhouse**, which will open the "Greenhouse Integration" instructions page in a new browser window + +## Create the Web hook + +1. Click the link under Step 1 on the Greenhouse Integration instructions page, or log into your Greenhouse account and navigate to **Configure > Dev Center > Web Hooks > Web Hooks**. +2. After landing on the "Create a New Web Hook" page, follow the steps on the Greenhouse Integration instructions page to create the web hook. + +## Create the custom candidate field + +1. Click the link under Step 2 on the Greenhouse Integration instructions page, or log into your Greenhouse account and navigate to **Configure > Custom Options > Custom Company Fields > Candidates** +2. Follow the steps on the Greenhouse Integration instructions page to create the custom Candidate field. +3. Click **Finish** (Step 3 on the Greenhouse Integration instructions page) to finish connecting Greenhouse with Expensify. + +# How to send candidates from Greenhouse to Expensify +## In Greenhouse: + +1. Log into Greenhouse and go to any candidate’s Details tab +2. Confirm that the Email field is filled in +3. Optionally select the Recruiter field to set the recruiter as the candidate's expense approver in Expensify (Note: if you'd prefer to have the Recruiting Coordinator used as the default approver, please reach out to concierge@expensify.com or your account manager to request that we change the default approver on your behalf) +4. Send this candidate to Expensify by toggling the **Invite to Expensify** field to **Yes** and clicking **Save** + +## In Expensify: + +1. Navigate to **Settings > Policies > Group > _[Workspace Name]_ > Members** +2. The candidate you just sent to Expensify should be listed in the workspace members list +3. If the Recruiter (or Recruiting Coordinator) field was filled in in Greenhouse, the candidate will already be configured to submit reports to that recruiter for approval. If no Recruiter was selected, then the candidate will submit based on the Expensify workspace approval settings.