1. Greenhouse Support
  2. All Recruiting topics
  3. Integrations
  4. HRIS Link
  5. Export hired candidates

FAQ: HRIS Link for hired candidates

HRIS Link allows you to export newly hired candidates from Greenhouse Recruiting to be synced with your preferred HRIS. This article provides answers to some frequently asked questions about HRIS Link.

In this article

How does HRIS Link export hired candidates?

When a candidate is marked as hired in Greenhouse Recruiting, HRIS Link will export a JSON or XML payload to the SFTP server or S3 bucket you choose.

What data is included in the payload for each hired candidate?

HRIS Link will export the following details for each candidate who is marked as hired in Greenhouse Recruiting:

Application details Source
Referrer
Custom application fields

Application ID

Resume and attachments

Take home test
Candidate details

Candidate profile URL

First name

Last name

Current job title

Private (True or false)

Recruiter

Coordinator

Can email? (Yes or no)

Email address

Phone number

Mailing address

Education

Employment

Custom candidate fields

Linked Greenhouse Recruiting user

Candidate ID
Job details

Job name

Job open and close dates

Requisition ID

Office, office location and office ID

Department and department ID

Custom job fields
Offer details

Offer ID

Offer creation and resolution dates

Start date

Custom offer fields

Offer letter
Opening details

Opening ID

Opening open and close dates

Target start date

Custom opening fields

Check out an example hired candidate payload below:

<?xml version="1.0">
<root>
 <metadata>
    <application-id type="integer">123</application-id>
    <candidate-id type="integer">0987654321</candidate-id>
    <first-name>Marilyn</first-name>
    <last-name>Reese</last-name>
    <requisition-id>R-10001</requisition-id>
    <job-name>Copywriter</job-name>
 </metadata>
<body>
  <root>
   <action>hire_candidate</action>
   <created-at>2023-01-10T22:07:48.123Z</created-at>
   <application>
     <id type="integer">0011223344</id>
     <url>https://people/0987654321?application_id=123</url>
    <source>
     <id type="integer">4000177004</id>
     <name>Internal Applicant</name>
    </source>
    <referrer>
     <id type="integer">4454519004</id>
     <email>referrer_test@example.com</email>
     <name>Haley Studdard</name>
     <employee-id>44444</employee-id>
    </referrer>
      <attachments type="array">
        <attachment>
         <filename>Marilyn_R.Offer(Private).pdf</filename>
         <url>https://exampleURL.com/attach/123</url>
         <type>offer_packet</type>
        </attachment>
        <attachment>
         <filename>Take_home_test.docx</filename>
         <url>https://exampleURL.com/attach/321</url>
         <type>take_home_test</type>
        </attachment>
        <attachment>
         <filename>Other_Doc.docx</filename>
         <url>https://exampleURL.com/attach/231</url>
         <type>other</type>
        </attachment>
        <attachment>
         <filename>Test.docx</filename>
         <url>https://exampleURL.com/person/213</url>
         <type>resume</type>
        </attachment>
        <attachment>
         <filename>Offer_Doc.0y.pdf</filename>
         <url>https://exampleURL.com/person/1230</url>
         <type>signed_offer_letter</type>
        </attachment>
        <attachment>
         <filename>Offer_Doc.y.docx</filename>
         <url>https://exampleURL.com/person/1234</url>
         <type>offer_letter</type>
        </attachment>
     </attachments>
     <custom-field-values type="array" />
   </application>
   <candidate>
     <id type="integer">43888521004</id>
     <external-id nil="true" />
     <linked-greenhouse-user>
       <id type="integer">4497321004</id>
       <email>MM@ymail.com</email>
       <name>Marilyn Reese</name>
       <employee-id>MM123</employee-id>
     </linked-greenhouse-user>
     <url>https://app4.greenhouse.io/people/123</url>
     <first-name>Marty</first-name>
     <last-name>McFly</last-name>
     <title nil="true" />
     <is-private type="boolean">true</is-private>
       <recruiter>
       <id type="integer">4454519004</id>
       <email>recruiter_test@ymail.com</email>
       <name>Sam Tare</name>
       <employee-id>22222</employee-id>
     </recruiter>
     <coordinator>
     <id type="integer">4454519007</id>
     <email>coordinator_test@ymail.com</email>
     <name>Courtney Ten</name>
     <employee-id>33331</employee-id>
     </coordinator>
     <can-email type="boolean">true</can-email>
     <email-addresses type="array">
        <email-address>
         <value>marilyn.reese@ymail.com</value>
         <type>personal</type>
        </email-address>
     </email-addresses>
     <phone-numbers type="array" />
     <addresses type="array" />
     <educations type="array">
        <education>
         <school-name>PSU - University Park</school-name>
         <degree>Bachelor's Degree</degree>
         <discipline>Art</discipline>
         <start-date>2000-08-15</start-date>
         <end-date>2004-05-15</end-date>
        </education>
     </educations>
     <employments type="array" />
     <custom-field-values type="array" />
   </candidate>
   <job>
     <id type="integer">4468769004</id>
     <name>Test Job</name>
     <close-date>2023-01-10T22:07:31.519Z</close-date>
     <open-date>2023-01-01T22:07:13.972Z</open-date>
     <requisition-id>R-10001</requisition-id>
     <offices type="array">
        <office>
         <id type="integer">4035493004</id>
         <name>London, UK</name>
         <location nil="true" />
         <external-id>LOCATION-LON-1</external-id>
        </office>
     </offices>
     <departments type="array">
        <department>
         <id type="integer">4062899004</id>
         <name>Finance</name>
         <external-id>150</external-id>
        </department>
     </departments>
     <custom-field-values type="array">
        <custom-field-value>
         <field-key>employment_type</field-key>
         <name>Employment Type</name>
         <type>single_select</type>
         <value>Full-time</value>
         <external-id nil="true" />
        </custom-field-value>
        <custom-field-value>
         <field-key>worker_sub_type</field-key>
         <name>Worker Sub-Type</name>
         <type>single_select</type>
         <value nil="true" />
         <external-id nil="true" />
        </custom-field-value>
        <custom-field-value>
         <field-key>cost_center</field-key>
         <name>Cost Center</name>
         <type>single_select</type>
         <value>LEXINGTON</value>
         <external-id nil="true" />
        </custom-field-value>
        <custom-field-value>
         <field-key>country</field-key>
         <name>Country</name>
         <type>single_select</type>
         <value>Europe</value>
         <external-id nil="true" />
        </custom-field-value>
        <custom-field-value>
         <field-key>location</field-key>
         <name>Location</name>
         <type>single_select</type>
         <value nil="true" />
         <external-id nil="true" />
        </custom-field-value>
        <custom-field-value>
         <field-key>req_open_since</field-key>
         <name>Req Open Since</name>
         <type>date</type>
         <value>2023-01-01</value>
         <external-id nil="true" />
        </custom-field-value>
        <custom-field-value>
         <field-key>date_request_entered</field-key>
         <name>Date Request Entered</name>
         <type>date</type>
         <value>2023-01-10</value>
         <external-id nil="true" />
        </custom-field-value>
        <custom-field-value>
         <field-key>reason</field-key>
         <name>Reason</name>
         <type>single_select</type>
         <value nil="true" />
         <external-id nil="true" />
        </custom-field-value>
        <custom-field-value>
         <field-key>job_posting_title</field-key>
         <name>Job Posting Title</name>
         <type>short_text</type>
         <value>Test Job</value>
         <external-id nil="true" />
        </custom-field-value>
        <custom-field-value>
         <field-key>worker_type</field-key>
         <name>Worker Type</name>
         <type>single_select</type>
         <value nil="true" />
         <external-id nil="true" />
        </custom-field-value>
        <custom-field-value>
         <field-key>company</field-key>
         <name>Company</name>
         <type>single_select</type>
         <value nil="true" />
         <external-id nil="true" />
        </custom-field-value>
        <custom-field-value>
         <field-key>business_unit</field-key>
         <name>Business Unit</name>
         <type>single_select</type>
         <value>Marketing and sales</value>
         <external-id nil="true" />
        </custom-field-value>
        <custom-field-value>
         <field-key>supervisory_org_title</field-key>
         <name>Supervisory Org - Title</name>
         <type>short_text</type>
         <value nil="true" />
         <external-id nil="true" />
        </custom-field-value>
        <custom-field-value>
         <field-key>job_profile</field-key>
         <name>Job Profile</name>
         <type>single_select</type>
         <value nil="true" />
         <external-id nil="true" />
        </custom-field-value>
        <custom-field-value>
         <field-key>job_family_group</field-key>
         <name>Job Family Group</name>
         <type>single_select</type>
         <value nil="true" />
         <external-id nil="true" />
        </custom-field-value>
        <custom-field-value>
         <field-key>job_family</field-key>
         <name>Job Family</name>
         <type>single_select</type>
         <value>Conference and Events</value>
         <external-id nil="true" />
        </custom-field-value>
        <custom-field-value>
         <field-key>job_level</field-key>
         <name>Job Level</name>
         <type>single_select</type>
         <value>Manager</value>
         <external-id nil="true" />
        </custom-field-value>
        <custom-field-value>
         <field-key>time_type</field-key>
         <name>Time Type</name>
         <type>single_select</type>
         <value>Full Time</value>
         <external-id nil="true" />
        </custom-field-value>
        <custom-field-value>
         <field-key>pay_rate_type</field-key>
         <name>Pay Rate Type</name>
         <type>single_select</type>
         <value>Salary</value>
         <external-id nil="true" />
        </custom-field-value>
       </custom-field-values>
   </job>
   <offer>
     <id type="integer">4704911004</id>
     <version type="integer">1</version>
     <sent-on nil="true" />
     <resolved-at>2023-01-10T22:07:31.473Z</resolved-at>
     <start-date>2023-02-14</start-date>
     <created-at>2023-01-10T17:57:22.136Z</created-at>
     <custom-field-values type="array">
        <custom-field-value>
         <field-key>employment_type</field-key>
         <name>Employment Type</name>
         <type>single_select</type>
         <value>Full-time</value>
         <external-id nil="true" />
        </custom-field-value>
        <custom-field-value>
         <field-key>pay_rate_type</field-key>
         <name>Pay Rate Type</name>
         <type>single_select</type>
         <value>Salary</value>
         <external-id nil="true" />
        </custom-field-value>
        <custom-field-value>
         <field-key>annual_salary</field-key>
         <name>Annual Salary</name>
         <type>currency</type>
         <value>
         <unit>USD</unit>
         <amount>150000.0</amount>
         </value>
         <external-id nil="true" />
        </custom-field-value>
        <custom-field-value>
         <field-key>time_type</field-key>
         <name>Time Type</name>
         <type>single_select</type>
         <value>Full Time</value>
         <external-id nil="true" />
        </custom-field-value>
        <custom-field-value>
         <field-key>cost_center</field-key>
         <name>Cost Center</name>
         <type>single_select</type>
         <value>LEXINGTON</value>
         <external-id nil="true" />
        </custom-field-value>
        <custom-field-value>
         <field-key>location</field-key>
         <name>Location</name>
         <type>single_select</type>
         <value nil="true" />
         <external-id nil="true" />
        </custom-field-value>
        <custom-field-value>
         <field-key>job_profile</field-key>
         <name>Job Profile</name>
         <type>single_select</type>
         <value nil="true" />
         <external-id nil="true" />
        </custom-field-value>
        <custom-field-value>
         <field-key>hire_type</field-key>
         <name>Hire Type</name>
         <type>single_select</type>
         <value>Internal Promotion (lateral)</value>
         <external-id nil="true" />
        </custom-field-value>
        <custom-field-value>
         <field-key>eeid__single_select_</field-key>
         <name>EEID (single select)</name>
         <type>single_select</type>
         <value>EEID - First_name last_name</value>
         <external-id nil="true" />
        </custom-field-value>
        <custom-field-value>
         <field-key>eeid__short_text_</field-key>
         <name>EEID (short text)</name>
         <type>short_text</type>
         <value>MM123</value>
         <external-id nil="true" />
        </custom-field-value>
        <custom-field-value>
         <field-key>relocation_bonus_eligible</field-key>
         <name>Relocation one time payment eligible</name>
         <type>single_select</type>
         <value>No</value>
         <external-id nil="true" />
        </custom-field-value>
        <custom-field-value>
         <field-key>sign_on_bonus_</field-key>
         <name>Sign On Bonus?</name>
         <type>boolean</type>
         <value type="boolean">true</value>
         <external-id nil="true" />
        </custom-field-value>
        <custom-field-value>
         <field-key>sign_on_bonus_amount</field-key>
         <name>Sign On Bonus Amount</name>
         <type>currency</type>
         <value>
         <unit>USD</unit>
         <amount>2500.0</amount>
         </value>
         <external-id nil="true" />
        </custom-field-value>
        <custom-field-value>
         <field-key>sign_on_bonus_payment_date</field-key>
         <name>Sign On Bonus Payment Date</name>
         <type>date</type>
         <value>2023-09-14</value>
         <external-id nil="true" />
        </custom-field-value>
     </custom-field-values>
   </offer>
   <opening>
     <id type="integer">4872462004</id>
     <open-date>2023-01-01</open-date>
     <close-date>2023-01-10</close-date>
     <opening-id>P-10001</opening-id>
     <target-start-date>2023-02-01</target-start-date>
     <custom-field-values type="array">
        <custom-field-value>
         <field-key>opening_field_test</field-key>
         <name>Opening Field Test</name>
         <type>boolean</type>
         <value type="boolean">true</value>
         <external-id nil="true" />
        </custom-field-value>
     </custom-field-values>
   </opening>
  </root>
</body>

Is it possible to exclude offices, departments, jobs, or candidates from HRIS Link for hired candidates?

No. Once enabled, each candidate who is marked as hired in Greenhouse Recruiting will be exported using HRIS Link, even if the candidate was previously marked as hired. It isn't possible to exclude certain offices, departments, jobs, or candidates from the export.

How do I import a hired candidate payload to my preferred HRIS?

You'll need to work with your internal development team or a third-party integration developer to construct the middleware required to import the data into your HRIS.