Troubleshooting and FAQ

this section covers a series of potential issues you may run into when setting up or configuring the greenhouse integration app, as well as provides answers to commonly asked questions harvest api key why is my harvest api key not working? if you're having trouble with your harvest api key, it's may most likely be due to your setup permissions please refer to the table below for a complete list of the necessary permissions type permissions applications get retrieve application get list applications candidates get retrieve candidate get list candidates users get retrieve user get list users get list user future job permissions get list user job permissions get list pending approvals put add a job permission offers get list application's offers get retrieve application's current offer get retrieve offer get list offers departments get retrieve department get list departments post create a new department patch update a department jobs get retrieve job get list jobs patch update job post create a new job put replace hiring team job posts get list job posts get retrieve job post for job get list job posts for job patch update job posts job stages get retrieve job stage get list job stages get list job stages for job job openings get list openings for a job post create openings delete delete openings patch edit openings offices get retrieve office get list offices post create a new office patch update an office user roles get list user roles if you are still unable to complete this step after attempting the troubleshooting options above, reach out to permissions which roles are able to use the greenhouse integration? there are two ootb access levels in charthop specifically designed for recruiters recruiting editor these users are allowed to view and make changes to open jobs, including target compensation levels and sensitive jobs they are not allowed to make changes to, or access sensitive data about current employees, other than those they manage this permission is generally intended for recruiting roles or those managing the ats recruiting view these users are allowed to view sensitive information about open jobs only, including target compensation levels and viewing all sensitive jobs they are not allowed to make changes to the primary timeline, or access sensitive information about current employees other than those they manage other access levels with the ability to open roles primary editor these users are allowed to view all information, and make official, permanent changes to the primary timeline this access should be restricted tightly and limited to a few authorized individuals in hr, finance, or similar roles owner these users are allowed full access to everything, including the ability to change user permissions, configure integrations, and alter organization wide settings because of the scope involved, this access should be tightly restricted metrics where do metrics come from? charthop, once daily, pulls a list of candidates in the ats, and updates metrics based on the stages that the candidates are in for more information about metrics data, reach out to charthop’s professional services team data sync updates when do updates for charthop to greenhouse job data flows push over? updates for charthop to greenhouse job data flows push over under the following cases if a job in charthop has not already been mapped to a greenhouse job/opening, the initial sync occurs when the job is set to active recruiting status in primary if a job in charthop has already been mapped to a greenhouse job/opening, updates sync over to greenhouse regardless of recruiting status when do charthop jobs get created for greenhouse to charthop job data syncs? charthop jobs are created for greenhouse to charthop job data syncs during the following if a greenhouse job/opening has not been mapped to a job in charthop, a new job is created in charthop if the greenhouse opening is open and greenhouse job status is either open or draft if a greenhouse job/opening has already been mapped to a job in charthop, then updates sync over to charthop regardless of status until the job is filled after that, no updates are synced how do i safely clean up roles that were accidentally duplicated during the sync? contact to fix this job data why did the job data flow fail? in case a job fails to be properly created, you can check for the following confirm that your api and webhook credentials are correct confirm that your hiring manager and recruiter have accounts in both charthop and greenhouse with the same email address private and standard job admin levels are supported by default custom levels are also supported, however, not by default (we attempt to give hiring managers and recruiters job admin levels to their assigned greenhouse jobs) ensure that the default job admin standard and job admin private levels have not been removed or renamed if the customer has a custom job admin role level instead in greenhouse (thereby the default job admin levels above do not exist) ensure that the job admin role level they want to give to hiring managers includes the word "hiring manager" (e g , could be called "charthop hiring manager") ensure that the job admin role level they want to give to recruiters includes the word "recruiter" (e g , could be called "charthop recruiter") ensure that your departments and teams match between charthop and greenhouse when matching departments and teams between charthop and greenhouse, the integration attempts to match on both the name, but also any aliases that exist in charthop confirm that your job templates names are an exact match between charthop and greenhouse check whether you have changed the standard required fields in greenhouse (e g , if you have set a non standard default or custom field to be required for job creation) if you have changed the required fields, contact your charthop implementation specialist so that they may ensure that your fields get mapped and passed in correctly confirm your greenhouse id matches the greenhouse job id/opening id combination to find the opening id, you can export greenhouse jobs from the apps page, or reach out to mailto\ support\@charthop com manually editing the greenhouseid in charthop will change what job it is connected to greenhouse comes with a set of default options for employment types if you change the employment type options in your greenhouse instance, please contact in order to configure them appropriately why did the new hire data flow fail? in the case a hiring fails, you can check the following confirm that an email has been provided for the candidate (either personal or work email) ensure that the greenhouse job id field is mapped to the correct job you can contact if you need assistance with this (we do not recommend changing this field manually) be aware that we do not support internal transfers if a marked new hire in greenhouse already fills another job in charthop, we recommend instead manually transferring the internal transfer in charthop directly job codes how does job code matching work by default? job code matching works in the following ways if a job in charthop has a job code attached to it, then when syncing to greenhouse, the integration attempts to match the jobcode code to the greenhouse job’s requisition id if a match is found, an opening is created underneath that greenhouse job, and the \[jobcode name]\(\<http //jobcode name>) syncs over to the greenhouse job name instead of the charthop job title if no match is found, the integration continues to use the default fallback logic (e g , matching under title, title and location, or none) for example, let’s say there’s a greenhouse job with requisition id of eng sr and title of sr engineer we create a job code in charthop, with the jobcode code being eng sr and \[jobcode name]\(\<http //jobcode name>) of senior engineer if we attach the job code to a charthop job that has the job title of engineer ii , when syncing over to greenhouse, the integration creates an opening to match underneath the existing greenhouse sr engineer job due to a match on the requisition id (eng sr) then, the job title in greenhouse changes to senior engineer to match the charthop jobcode name for this reason, we generally expect users to keep job codes consistent with existing greenhouse jobs can i match by job code and still map a charthop job title to a greenhouse job title? yes you can! this can be done by disabling the jobcode name to job requisition name field mapper in greenhouse for additional help with field mappings, please contact support at by doing so, the expected behavior is the same as the above, however, charthop won’t utilize the job code name and instead uses charthop job title for example, if you have an operations associate job in charthop with a job code attached that has a job code name of operations roles if charthop matches using the jobcode to a greenhouse job, then we’ll utilize the charthop job title operations associate instead of the job code name of operations roles if charthop doesn’t find any matches, it creates a new greenhouse job, passing in the jobcode code as the greenhouse requisition id the charthop job title as the greenhouse job title job status why was the recruit status for a charthop job changed to pending? recruit status can change to pending for one of three reasons the status was manually changed the integration received a new hire webhook (pending new hire) for the job changing the offer accept date effectively dates recruit status changing to pending on the date selected for the offer acceptance date ats setup how should i support the setup for my ats when there are different departments or teams between my ats and payroll system? the best practice is to leverage aliases when aliases are present, if the department or team name doesn’t work, charthop attempts with aliases, next for example, if the department in greenhouse is contractor but the department in charthop is contract, if there is an alias attached to the charthop department called contractor, charthop will be able to sync into greenhouse’s contractor department new hire data what does the new hire data webhook pull in? can i pull in custom fields? this can be referenced in the field mappers table, with anything from the candidate or offer endpoints webhook field mappers we also support additional custom field mapping to custom fields in greenhouse that are tied to the offer object in greenhouse