Greenhouse → Ashby Recruiting API Migration

this guide covers how to configure the api migration from greenhouse to ashby the migration only retrieves data, and does not create, update, or delete anything in your greenhouse account prerequisites you must be an organization admin in ashby to configure the migration settings you must have can manage all organization's api credentials access in greenhouse to configure the required api credentials step one generate api credentials to create your api credentials (also referred to as a client id and client secret pair) for the greenhouse migration in greenhouse, click the configure icon > dev center > api credential management click create new api credentials fill in the fields api type harvest v3 (oauth) description something identifiable, e g , "data sync integration" (do not include "ashby" in the description) if you see a partner field, select custom integration proceed to the permissions/scopes screen set the required scopes select read scopes on all objects this grants "list" access, meaning ashby can list data for each object we recommend selecting all "list " endpoints you may see items such as harvest\ candidates\ list harvest\ applications\ list harvest\ notes\ list harvest\ application stages\ list (other endpoints) save the credential copy the client id and client secret after saving, greenhouse displays your client id and client secret greenhouse shows the client secret only once if you click past this screen without copying it, you need to rotate the credential to generate a new one the client id remains visible afterward, but the secret does not copy both values to a secure location step two configure webhooks you need to configure 15 webhooks for the api migration this step ensures that ashby and greenhouse sync key events accurately for more on configuring webhooks, see setting up greenhouse webhooks docid\ hgfqaxe7ecyxqsb2wjkor step three enter your api credentials in ashby you can find your greenhouse integration configuration in your admin section by navigating to admin > integrations > greenhouse https //app ashbyhq com/admin/integrations/greenhouse this is where you enter your api credentials and subdomain the greenhouse integration page in ashby client id enter your client id (or client key) client secret enter your generated client secret custom subdomain enter your custom subdomain to enable linking directly to candidate profiles from ashby adding the api credentials initiates your initial data sync after your initial data sync completes, regular syncs continue once per hour to automatically ingest new data and updates ashby displays the last successful sync time in your ashby user's timezone what information is migrated from greenhouse? the api migration pulls the following data from greenhouse departments offices jobs openings job stages custom fields candidates (including candidate notes) the migration does not pull over candidate consent dates or data retention dates you can import data retention dates via a csv import to add this information to migrated candidates once the api migration is complete for more information, see data privacy and compliance docid 0xpiflekfhkukbufqkhi9 users (the migration explicitly does not map user permissions) scorecards sources candidate tags job posts offers (the migration pulls over existing offers, offer data, and offer letters, which you can find within candidate profiles, but it does not pull over offer letter templates) resumes rejection reasons ashby syncs rejection reasons and rejection reason custom fields ashby syncs rejection reason fields in greenhouse as custom fields for archive reasons in ashby rejection questions scheduled interviews degrees disciplines eeoc email templates ashby migrates both organization and personal email templates ashby does not replace placeholder tokens, so you must update templates to include substitution tokens in ashby close reasons demographic questions (these come over as a diversity survey in ashby) application form submissions ashby can also sync and map emails upon request faqs will something happen to feedback forms or other things we create in ashby prior to the migration? if you create an object in ashby (e g , a feedback form template), the migration leaves it unchanged that said, the migration moves over the objects listed above, so we recommend completing the migration first to prevent duplicating effort help! i updated a candidate profile, but it changed back overnight! letting your customer success manager (csm) know when they can disable the ats sync is part of the migration process until that step is complete, any changes you make to migrated data may be overridden do you migrate prospects from greenhouse? ashby doesn't map any prospect related data, so ashby maps candidates who only have a prospect application as candidates with a lead status they do not have a job consideration attached to their profile why can't i see the email templates migrated from greenhouse in my account? because you need to replace the substitution tokens in your email templates with ashby tokens, ashby syncs email templates over as archived templates we recommend updating your email templates and then restoring them to use them moving forward to amend and restore your email templates, navigate to admin > organization setup > email templates then use the active dropdown to switch the view to see all email templates click the email template in question and make the required updates, clicking the t icon in the email toolbar to access and add substitution tokens (for more information, see substitution tokens docid\ p8ax 2lzye5qh7grothr6 ) once you've updated your email template, click more , then restore , to make it an active template