1. Greenhouse Support
  2. All Recruiting topics
  3. Integrations
  4. Custom integrations
  5. Custom HRIS integrations
  6. Workflows

Document types available via the candidate hired webhook

This article is intended for customers using the candidate hired webhook to export candidates to an HRIS or other downstream system. We'll cover each document type that is included in the export and distinguish the differences between them to help developers understand the appropriate document types to retrieve.

In this article

Candidate profile file attachment types

There are several file attachment types that can be associated with candidate profiles:

  • Resume
  • Cover letter
  • Take home test
  • Other
  • Offer letter
  • Signed offer letter
  • Offer packet

In the Greenhouse Recruiting interface, all of these attachments are available via the candidate Details tab in the All Attachments section.

Candidate hired webhook payload

Note: Payload attachments for candidate hired web hooks expire in seven (7) days. You should immediately download the document to avoid expired attachments.

The candidate hired webhook can include each of the following document types:

Note: If the candidate has been hired on multiple jobs, the payload may include more than one of each document type.

Resume ("type": "resume")

"attachments": [ 
 {
  "filename": "Cindy Bananas resume.docx",
  "url": "https://prod-heroku.s3.amazonaws.com/person_attachments/data/141/821/232/original/Cindy%20Bananas%20resume.docx?AWSAccessKeyId=AKIAI2HNOZGNEUVWYNFQ&Expires=1557437095&Signature=11SDNrS%2Ba8Xv2rkf8tNANQi3Msc%3D",
  "type": "resume"
  }
  ],

Cover letter ("type": "cover_letter")

"attachments": [ 
{
"filename": "Cover_Letter_Template_(pdf).pdf",
"url": "https://prod-heroku.s3.amazonaws.com/person_attachments/data/144/217/287/original/Cover_Letter_Template_%28pdf%29.pdf?AWSAccessKeyId=AKIAI2HNOZGNEUVWYNFQ&Expires=1557437095&Signature=PPWwt8N8R5MniDCgxVu5%2B4fER8g%3D",
"type": "cover_letter"
},
],

Take home test ("type": "take_home_test")

"attachments": [ 
{
"filename": "File1.docx",
"url": "https://prod-heroku.s3.amazonaws.com/person_attachments/data/144/217/491/original/File1.docx?AWSAccessKeyId=AKIAI2HNOZGNEUVWYNFQ&Expires=1557437095&Signature=3eF7ycK7y8PQUT4uEFCswNe7fAY%3D",
"type": "take_home_test"
},
],

Offer letter ("type": "offer_letter")

Word and PDF versions of the unsigned offer letter to be sent to the candidate for signature.

"attachments": [ 
{
"filename": "Offer_Document_Cindy_Bananas.docx",
"url": "https://prod-heroku.s3.amazonaws.com/person_attachments/data/144/218/016/original/Offer_Document_Cindy_Bananas.docx?AWSAccessKeyId=AKIAI2HNOZGNEUVWYNFQ&Expires=1557437095&Signature=sDyX27SRU%2BW6BotfHE%2F%2B%2FVcES5s%3D",
"type": "offer_letter"
},
],

Signed offer letter ("type": "signed_offer_letter")

The final and fully executed offer document.

"attachments": [ 
{
"filename": "Offer_Doc-signed.pdf",
"url": "https://prod-heroku.s3.amazonaws.com/person_attachments/data/144/218/330/original/Offer_Doc-signed.pdf?AWSAccessKeyId=AKIAI2HNOZGNEUVWYNFQ&Expires=1557437095&Signature=gRjpxWRZukDS0BdXGf1jsnnqawk%3D",
"type": "signed_offer_letter"
},
],

Offer packet ("type": "offer_packet")

Aggregation of data from the candidate, application, offer, scorecard, and attachment objects.

"attachments": [ 
 {
"filename": "Cindy_Bananas_-_Offer_Packet_2019-04-09_(Private).pdf",
"url": "https://prod-heroku.s3.amazonaws.com/person_attachments/data/144/219/098/original/Cindy_Bananas_-_Offer_Packet_2019-04-09_%28Private%29.pdf?AWSAccessKeyId=AKIAI2HNOZGNEUVWYNFQ&Expires=1557437095&Signature=T0taxRZkK2MQhcjKwon1VaVLZMU%3D",
"type": "offer_packet"
},
],

Note: In order to ensure the data in the packet is always up to date, the offer packet regenerates every time a change is made to data in the candidate, application, offer, scorecard, or attachment objects. This also causes the previous document to expire and become inaccessible.

Other ("type": "admin_only")

Customers may use this attachment type for a candidate’s portfolio, custom take home tests, or other documents that do not fall under the above categories and that are uploaded manually to Greenhouse.

 "attachments": [ 
{
"filename": "Other_Doc_Test.docx",
"url": "https://prod-heroku.s3.amazonaws.com/person_attachments/data/144/217/460/original/Other_Doc_Test.docx?AWSAccessKeyId=AKIAI2HNOZGNEUVWYNFQ&Expires=1557437095&Signature=agW0H5Xefy%2FXkeh0K6Z0nE8neSs%3D",
"type": "other"
},
],

Add resume, cover letter, or other document to an existing candidate

You can add any document type to an existing candidate in Greenhouse Recruiting by navigating to the Candidate Details tab > All Attachments section:

Screenshot of add new file button on a candidate's Details tab

You can add any document to an existing candidate via Greenhouse Harvest API with a POST: Add Attachment request, including either the base64-encoded file content or a URL where the file is hosted. 

Example

  curl -X POST \
  https://harvest.greenhouse.io/v1/candidates/[candidate_id]/attachments \
  -H 'Authorization: Basic ***********' \
  -H 'Content-Type: application/json' \
  -H 'on-behalf-of: 1049756' \
  -d '{
  "filename" : "resume.pdf",
  "type" : "resume",
  "content" : "JVBERi0xLjMKJcTl8uXrp/Og0MTGCjQgMCBvYmoKPD…",
  "content_type" : "application/pdf"
  }'
Note: When adding an Other document type, you can select to add the document as:
  • Public: Visible to Site Admins, Job Admins, or Interviewers who are assigned to the job
  • Admin Only: Visible to Site Admins and Job Admins who are assigned to the job
  • Private: Visible only to Site Admins with the user-specific permission Can see private notes, salary info, manage offers, and approve jobs/offers, and Job Admins with the permission stripe Can view and edit private candidate and application fields

Refer to the following article for more details on each visibility setting: Access candidate attachments.

Add a take home test document to existing candidate

  • Take home tests submitted by a candidate through a special Greenhouse Recruiting take home test stage will be added to the candidate profile automatically.
  • Take home tests can also be manually uploaded to a take home test stage by a Greenhouse Recruiting user (if the test is submitted by email).

Note: In addition to the candidate Details tab, you can also access the take home test document via the take home test interview kit (accessed by clicking Take Home Test).

Take home test documents from third-party integrations (for example, HackerRank) will not be added to the candidate profile. Instead, results are accessible via a URL to the partner platform.

Add an offer letter document type to an existing candidate

In Greenhouse Recruiting, move the candidate to the Offer stage and navigate to the Offer Details page.

Screenshot of example Offer Details button on a candidate profile

Click Create Offer and fill out the relevant Offer Details. Click Save when finished.

Select Upload to manually upload an offer document that was created outside of Greenhouse Recruiting, or Generate to populate a Greenhouse Recruiting offer letter template using the offer details you provided in the previous step.

Add signed_offer_letter document type to an existing candidate

The signed offer letter document type is automatically added to Greenhouse when a Candidate signs a document through the Greenhouse Recruiting / DocuSign integration, or when a signed offer letter is uploaded manually to the candidate profile on the Offer Details tab.

Add offer packet document to an existing candidate

This feature is unavailable because offer packets are automatically generated by Greenhouse Recruiting.

Retrieve documents from a candidate profile

The above documents are included in the attachments array in the Candidate Hired webhook, or can be returned (also in the attachments array) via the Harvest API (GET: Retrieve Candidate). We recommend the latter for pulling the offer packet to ensure you have the latest active link.