CINXE.COM

<!doctype html> <html lang="en"> <head> <meta charset="utf-8"> <meta content="IE=edge,chrome=1" http-equiv="X-UA-Compatible"> <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1"> <link rel="manifest" href="/images/favicons/manifest.json"> <link rel="icon" href="images/favicons/favicon.ico" sizes="32x32"> <link rel="icon" href="images/favicons/icon.svg" type="image/svg+xml"> <link rel="apple-touch-icon" href="images/favicons/apple-touch-icon.png"> <meta name="theme-color" content="#047957"> <title>Webhooks | Greenhouse</title> <style media="screen"> .highlight table td { padding: 5px; } .highlight table pre { margin: 0; } .highlight, .highlight .w { color: #f8f8f2; background-color: #272822; } .highlight .err { color: #272822; background-color: #f92672; } .highlight .c, .highlight .ch, .highlight .cd, .highlight .cm, .highlight .cpf, .highlight .c1, .highlight .cs { color: #75715e; } .highlight .cp { color: #f4bf75; } .highlight .nt { color: #f4bf75; } .highlight .o, .highlight .ow { color: #f8f8f2; } .highlight .p, .highlight .pi { color: #f8f8f2; } .highlight .gi { color: #a6e22e; } .highlight .gd { color: #f92672; } .highlight .gh { color: #66d9ef; background-color: #272822; font-weight: bold; } .highlight .k, .highlight .kn, .highlight .kp, .highlight .kr, .highlight .kv { color: #ae81ff; } .highlight .kc { color: #fd971f; } .highlight .kt { color: #fd971f; } .highlight .kd { color: #fd971f; } .highlight .s, .highlight .sb, .highlight .sc, .highlight .dl, .highlight .sd, .highlight .s2, .highlight .sh, .highlight .sx, .highlight .s1 { color: #a6e22e; } .highlight .sa { color: #ae81ff; } .highlight .sr { color: #a1efe4; } .highlight .si { color: #cc6633; } .highlight .se { color: #cc6633; } .highlight .nn { color: #f4bf75; } .highlight .nc { color: #f4bf75; } .highlight .no { color: #f4bf75; } .highlight .na { color: #66d9ef; } .highlight .m, .highlight .mb, .highlight .mf, .highlight .mh, .highlight .mi, .highlight .il, .highlight .mo, .highlight .mx { color: #a6e22e; } .highlight .ss { color: #a6e22e; } </style> <style media="print"> * { -webkit-transition:none!important; transition:none!important; } .highlight table td { padding: 5px; } .highlight table pre { margin: 0; } .highlight, .highlight .w { color: #586e75; } .highlight .err { color: #002b36; background-color: #dc322f; } .highlight .c, .highlight .ch, .highlight .cd, .highlight .cm, .highlight .cpf, .highlight .c1, .highlight .cs { color: #657b83; } .highlight .cp { color: #b58900; } .highlight .nt { color: #b58900; } .highlight .o, .highlight .ow { color: #93a1a1; } .highlight .p, .highlight .pi { color: #93a1a1; } .highlight .gi { color: #859900; } .highlight .gd { color: #dc322f; } .highlight .gh { color: #268bd2; background-color: #002b36; font-weight: bold; } .highlight .k, .highlight .kn, .highlight .kp, .highlight .kr, .highlight .kv { color: #6c71c4; } .highlight .kc { color: #cb4b16; } .highlight .kt { color: #cb4b16; } .highlight .kd { color: #cb4b16; } .highlight .s, .highlight .sb, .highlight .sc, .highlight .dl, .highlight .sd, .highlight .s2, .highlight .sh, .highlight .sx, .highlight .s1 { color: #859900; } .highlight .sa { color: #6c71c4; } .highlight .sr { color: #2aa198; } .highlight .si { color: #d33682; } .highlight .se { color: #d33682; } .highlight .nn { color: #b58900; } .highlight .nc { color: #b58900; } .highlight .no { color: #b58900; } .highlight .na { color: #268bd2; } .highlight .m, .highlight .mb, .highlight .mf, .highlight .mh, .highlight .mi, .highlight .il, .highlight .mo, .highlight .mx { color: #859900; } .highlight .ss { color: #859900; } </style> <link href="stylesheets/screen_webhooks.css" rel="stylesheet" media="screen" /> <link href="stylesheets/print.css" rel="stylesheet" media="print" /> <script src="javascripts/all.js"></script> <script type="text/javascript"> !function(){var analytics=window.analytics=window.analytics||[];if(!analytics.initialize)if(analytics.invoked)window.console&&console.error&&console.error("Segment snippet included twice.");else{analytics.invoked=!0;analytics.methods=["trackSubmit","trackClick","trackLink","trackForm","pageview","identify","reset","group","track","ready","alias","page","once","off","on"];analytics.factory=function(t){return function(){var e=Array.prototype.slice.call(arguments);e.unshift(t);analytics.push(e);return analytics}};for(var t=0;t<analytics.methods.length;t++){var e=analytics.methods[t];analytics[e]=analytics.factory(e)}analytics.load=function(t){var e=document.createElement("script");e.type="text/javascript";e.async=!0;e.src=("https:"===document.location.protocol?"https://":"http://")+"cdn.segment.com/analytics.js/v1/"+t+"/analytics.min.js";var n=document.getElementsByTagName("script")[0];n.parentNode.insertBefore(e,n)};analytics.SNIPPET_VERSION="3.1.0"; analytics.load("2q7wwCrJormvWKrplqZYR2gXyxLK5Uhx"); analytics.page() }}(); </script> </head> <body class="webhooks" data-languages="["json"]"> <a href="#" id="nav-button"> NAV <img src="images/navbar.png" alt="" /> </a> <div class="toc-wrapper"> <a href="/" class="nav-home-link"> <div class="nav-home"> <img src="images/logo.png" class="logo" alt="" /> Developers Home </div> </a> <div class="lang-selector"> <a href="#" data-language-name="json">json</a> </div> <div class="search"> <input type="text" class="search" id="input-search" placeholder="Search"> </div> <ul class="search-results"></ul> <ul id="toc" class="toc-list-h1"> <li> <a href="#introduction" class="toc-h1 toc-link" data-title="Introduction">Introduction</a> <ul class="toc-list-h2"> <li> <a href="#what-is-a-webhook" class="toc-h2 toc-link" data-title="What is a webhook?">What is a webhook?</a> </li> <li> <a href="#creating-a-webhook" class="toc-h2 toc-link" data-title="Creating a webhook">Creating a webhook</a> </li> <li> <a href="#advanced-settings" class="toc-h2 toc-link" data-title="Advanced settings">Advanced settings</a> </li> <li> <a href="#authentication" class="toc-h2 toc-link" data-title="Authentication">Authentication</a> </li> <li> <a href="#common-attributes" class="toc-h2 toc-link" data-title="Common Attributes">Common Attributes</a> </li> <li> <a href="#custom-fields" class="toc-h2 toc-link" data-title="Custom Fields">Custom Fields</a> </li> <li> <a href="#disabled-webhooks" class="toc-h2 toc-link" data-title="Disabled webhooks">Disabled webhooks</a> </li> <li> <a href="#retry-policy" class="toc-h2 toc-link" data-title="Retry policy">Retry policy</a> </li> </ul> </li> <li> <a href="#application-events" class="toc-h1 toc-link" data-title="Application Events">Application Events</a> <ul class="toc-list-h2"> <li> <a href="#application-created" class="toc-h2 toc-link" data-title="Application created">Application created</a> </li> <li> <a href="#application-deleted" class="toc-h2 toc-link" data-title="Application deleted">Application deleted</a> </li> <li> <a href="#application-updated" class="toc-h2 toc-link" data-title="Application updated">Application updated</a> </li> <li> <a href="#offer-created" class="toc-h2 toc-link" data-title="Offer created">Offer created</a> </li> <li> <a href="#offer-approved" class="toc-h2 toc-link" data-title="Offer approved">Offer approved</a> </li> <li> <a href="#offer-updated" class="toc-h2 toc-link" data-title="Offer updated">Offer updated</a> </li> <li> <a href="#offer-deleted" class="toc-h2 toc-link" data-title="Offer deleted">Offer deleted</a> </li> <li> <a href="#prospect-created" class="toc-h2 toc-link" data-title="Prospect created">Prospect created</a> </li> </ul> </li> <li> <a href="#candidate-events" class="toc-h1 toc-link" data-title="Candidate Events">Candidate Events</a> <ul class="toc-list-h2"> <li> <a href="#candidate-deleted" class="toc-h2 toc-link" data-title="Candidate deleted">Candidate deleted</a> </li> <li> <a href="#candidate-hired" class="toc-h2 toc-link" data-title="Candidate hired">Candidate hired</a> </li> <li> <a href="#candidate-merged" class="toc-h2 toc-link" data-title="Candidate merged">Candidate merged</a> </li> <li> <a href="#candidate-stage-change" class="toc-h2 toc-link" data-title="Candidate stage change">Candidate stage change</a> </li> <li> <a href="#candidate-unhired" class="toc-h2 toc-link" data-title="Candidate unhired">Candidate unhired</a> </li> <li> <a href="#candidate-prospect-rejected" class="toc-h2 toc-link" data-title="Candidate/Prospect rejected">Candidate/Prospect rejected</a> </li> <li> <a href="#candidate-prospect-unrejected" class="toc-h2 toc-link" data-title="Candidate/Prospect unrejected">Candidate/Prospect unrejected</a> </li> <li> <a href="#candidate-prospect-updated" class="toc-h2 toc-link" data-title="Candidate/Prospect updated">Candidate/Prospect updated</a> </li> <li> <a href="#candidate-anonymized" class="toc-h2 toc-link" data-title="Candidate anonymized">Candidate anonymized</a> </li> </ul> </li> <li> <a href="#interview-events" class="toc-h1 toc-link" data-title="Interview Events">Interview Events</a> <ul class="toc-list-h2"> <li> <a href="#interview-deleted" class="toc-h2 toc-link" data-title="Interview deleted">Interview deleted</a> </li> <li> <a href="#scorecard-deleted" class="toc-h2 toc-link" data-title="Scorecard deleted">Scorecard deleted</a> </li> </ul> </li> <li> <a href="#job-events" class="toc-h1 toc-link" data-title="Job Events">Job Events</a> <ul class="toc-list-h2"> <li> <a href="#job-created" class="toc-h2 toc-link" data-title="Job created">Job created</a> </li> <li> <a href="#job-deleted" class="toc-h2 toc-link" data-title="Job deleted">Job deleted</a> </li> <li> <a href="#job-updated" class="toc-h2 toc-link" data-title="Job updated">Job updated</a> </li> <li> <a href="#job-approved" class="toc-h2 toc-link" data-title="Job Approved">Job Approved</a> </li> <li> <a href="#job-post-created" class="toc-h2 toc-link" data-title="Job Post created">Job Post created</a> </li> <li> <a href="#job-post-updated" class="toc-h2 toc-link" data-title="Job Post updated">Job Post updated</a> </li> <li> <a href="#job-post-deleted" class="toc-h2 toc-link" data-title="Job Post deleted">Job Post deleted</a> </li> <li> <a href="#job-stage-deleted" class="toc-h2 toc-link" data-title="Job Stage deleted">Job Stage deleted</a> </li> </ul> </li> <li> <a href="#organization-events" class="toc-h1 toc-link" data-title="Organization Events">Organization Events</a> <ul class="toc-list-h2"> <li> <a href="#department-deleted" class="toc-h2 toc-link" data-title="Department deleted">Department deleted</a> </li> <li> <a href="#office-deleted" class="toc-h2 toc-link" data-title="Office deleted">Office deleted</a> </li> </ul> </li> </ul> <ul class="toc-appendage"> <li id="github_link"><a href="https://github.com/grnhse/greenhouse-api-docs/tree/master/source/includes/webhooks" title="View on Github" target="_blank">View on GitHub</a></li> </ul> <ul class="toc-footer"> <li><a href='/assessment.html' title="Assessment API">Assessment API</a></li> <li><a href='/audit-log.html' title="Audit Log API">Audit Log API</a></li> <li><a href="/harvest.html" title="Harvest API">Harvest API</a></li> <li><a href='/candidate-ingestion.html' title="Ingestion API">Ingestion API</a></li> <li><a href="/job-board.html" title="Job Board API">Job Board API</a></li> <li><a href='/gho.html' title="Onboarding API">Onboarding API</a></li> </ul> </div> <div class="page-wrapper"> <div class="dark-box"></div> <div class="content"> <h1 id='introduction'>Introduction</h1><h2 id='what-is-a-webhook'>What is a webhook?</h2> A webhook is a simple event-notification system. When an event occurs in Greenhouse, a payload of JSON data containing information about the event is sent via POST to a specified endpoint URL over HTTPS. Each delivery will include a <code>Greenhouse-Event-ID</code> header. This will contain an unique id associated with this delivery. <h2 id='creating-a-webhook'>Creating a webhook</h2> Webhooks have three components. A name, an endpoint URL, and a secret key. <ul> <li>Name: The name is simply a reference for you. It can contain any string value.</li> <li>Endpoint URL: This is the URL to which we will send the POST data when the event occurs. This must be a valid URL and must be https. When the webhook is saved or updated, we will attempt to ping this URL with a payload containing some configuration settings for the webhook. If this ping fails, we will create the webhook in a disabled state and notify you that the ping has failed.</li> <li>Secret Key: This secret key will be used to generate a signature header that you may use to verify the hook data was sent from Greenhouse. The secret key will be used in conjunction with the webhook's payload to generate a digital signature.</li> </ul> <h2 id='advanced-settings'>Advanced settings</h2> Advanced settings allow customers with certain other security needs to use webhooks for their system. In most cases, users will not need to configure these. <ul> <li>Basic authentication username / password: These credentials are supplied if the webhook request needs to authenticate at the destination with HTTP Basic Authorization. These credentials will be encoded in to a HTTP Authorization header. See RFC 2617 for additional details.</li> <li>Additional Headers: This textarea should contain any additional HTTP headers that will allow the POST request access to your environment. These headers will be included exactly as pasted, but may not include the following headers already reserved by Greenhouse: Content-Type, Content-Length, Greenhouse-Event-ID, Authorization, User-Agent, and Signature. Please consult with your technology department before including anything in this field.</li> </ul> <h2 id='authentication'>Authentication</h2><div class="highlight"><pre class="highlight plaintext"><code>Signature: sha256 37d2725109df92747ffcee59833a1d1262d74b9703fa1234c789407218b4a4ef </code></pre></div> <blockquote> To compute the HMAC digest in Ruby: </blockquote> <div class="highlight"><pre class="highlight ruby tab-ruby"><code>digest = OpenSSL::Digest.new('sha256') signature = OpenSSL::HMAC.hexdigest(digest, secret_key, body) </code></pre></div> <blockquote> To compute the HMAC digest in PHP: </blockquote> <div class="highlight"><pre class="highlight php tab-php"><code><?php // Requires PHP >= 5.1.2 and PECL hash >= 1.1 $signature = hash_hmac('sha256', $body, $secret_key); ?> </code></pre></div> <blockquote> The <code>body</code> variable in the above code samples refers to the entire content of the JSON response. Not just the <code>payload</code> attribute. </blockquote> Greenhouse uses a digital signature which is generated using the secret key entered when creating a webhook and the body of the webhook's request. This data is contained within the Signature header. The header contains: the SHA algorithm used to generate the signature, a space, and the signature. To verify the request came from Greenhouse, compute the HMAC digest using your secret key and the body and compare it to the signature portion (after the space) contained in the header. If they match, you can be sure the webhook was sent from Greenhouse. Important note on Unicode: Greenhouse will escape Unicode characters when they are encoded as JSON before computing the signature. For example, if the job post content is <code>hello</code>, the webhook body will represent it as <code>\u003cp\u003ehello\u003c/p\u003e</code>. When we compute the signature, we use the string exactly as it appears in the body, including the escaped unicode. Be sure to duplicate this process on the receiving end so the signatures match. <h2 id='common-attributes'>Common Attributes</h2> Currently, Webhooks for all event types include these common attributes: <table><thead> <tr> <th>Attribute</th> <th>Note</th> </tr> </thead><tbody> <tr> <td><code>application.id</code></td> <td>Unique Greenhouse identifier of the application. Information not included in the webhook can be retrieved via <a href="harvest.html#applications">Harvest API - GET Applications</a></td> </tr> <tr> <td><code>application.credited_to</code></td> <td>If populated and a Greenhouse user, the user's Greenhouse ID, e-mail address, and Employee ID (if available) will be provided. If populated and not a Greenhouse user, just the name will be provided.</td> </tr> <tr> <td><code>application.status</code></td> <td>One of: <code>rejected</code>, <code>hired</code>, <code>active</code></td> </tr> <tr> <td><code>application.candidate.id</code></td> <td>Unique Greenhouse identifier of the candidate. Information not included in the webhook can be retrieved via <a href="harvest.html#candidates">Harvest API - GET Candidates</a></td> </tr> <tr> <td><code>application.candidate.phone_numbers[].type</code></td> <td>One of: <code>home</code>, <code>work</code>, <code>mobile</code>, <code>skype</code>, <code>other</code></td> </tr> <tr> <td><code>application.candidate.addresses[].type</code></td> <td>Application Candidate Addresses Type</td> </tr> <tr> <td><code>application.candidate.email_addresses[].type</code></td> <td>One of: <code>personal</code>, <code>work</code>, <code>other</code></td> </tr> <tr> <td><code>application.candidate.attachments[].type</code></td> <td>One of: <code>cover_letter</code>, <code>offer_packet</code>, <code>resume</code>, <code>take_home_test</code>, <code>offer_letter</code>, <code>signed_offer_letter</code> Note: Attachments expire in 7 days.</td> </tr> <tr> <td><code>application.candidate.external_id</code></td> <td>An arbitrary ID provided by an external source; does not map to another entity in Greenhouse.</td> </tr> <tr> <td><code>application.prospect</code></td> <td>If true, this is a prospect application which means that the associated person is a prospect and has not yet applied for this job. (Only prospects will have non-null values for <code>prospect_owner</code>, <code>prospect_pool</code>, or <code>prospect_stage</code> under <code>prospect_detail</code>)</td> </tr> <tr> <td><code>application.prospect_detail.prospect_owner</code></td> <td>The user responsible for keeping track of the prospect. Either null or a user's <code>id</code> and <code>name</code></td> </tr> <tr> <td><code>application.prospect_detail.prospect_pool</code></td> <td>The current prospect pool of a prospect. Either null or a pool's <code>id</code> and <code>name</code></td> </tr> <tr> <td><code>application.prospect_detail.prospect_stage</code></td> <td>The current prospect stage of a prospect. Either null or a stage's <code>id</code> and <code>name</code></td> </tr> <tr> <td><code>application.jobs[]</code></td> <td>Candidates will have one job. Prospects will have 0 or more jobs.</td> </tr> <tr> <td><code>application.jobs[].id</code></td> <td>Unique Greenhouse identifier of the job. Information not included in the webhook can be retrieved via <a href="harvest.html#jobs">Harvest API - GET Jobs</a></td> </tr> <tr> <td><code>application.jobs[].requisition_id</code></td> <td>An arbitrary ID provided by an external source; does not map to another entity in Greenhouse.</td> </tr> <tr> <td><code>application.opening.opening_id</code></td> <td>This is an external opening id that may be defined for an HRIS system. This does not reference anything else in Greenhouse and may be blank.</td> </tr> <tr> <td><code>custom_fields</code></td> <td>Contains a hash map/associative array. The key of the hash map is an immutable key; which is an underscore-slugged version of the custom field's name at creation time. The exported properties reflect the active values of the custom field at the time of the export. All custom fields, public and private, will be exported. If a field exists but does not have a value, it will be exported with a value of null for singular values and empty arrays for multiple values. Important Note: If a custom field is created with the name <code>Salary</code> the key will be <code>salary</code>. If later the name of this custom field is changed to <code>Wage</code> or <code>Bonus</code>, the key will remain <code>salary</code>.</td> </tr> <tr> <td><code>custom_fields[].type</code></td> <td>One of: <code>short_text</code>, <code>long_text</code>, <code>boolean</code>, <code>single_select</code>, <code>multi_select</code>, <code>currency</code>, <code>currency_range</code>, <code>number</code>, <code>number_range</code>, <code>date</code>, <code>url</code>, or <code>user</code>.</td> </tr> </tbody></table> <h2 id='custom-fields'>Custom Fields</h2><div class="highlight"><pre class="highlight json tab-json"><code> { "custom_fields": { "short_text_field": { "name": "Short Text Field", "type": "short_text", "value": "A text string with fewer than 255 characters." }, "long_text_field": { "name": "Long Text Field", "type": "long_text", "value": "A text string of any length." }, "boolean_field": { "name": "Boolean Field", "type": "boolean", "value": true (or false) }, "single_select": { "name": "Single Select Field", "type": "single_select", "value": "The text of selected custom field option." }, "multi_select": { "name": "Multi Select Field", "type": "multi_select", "value": [ "An array containing the text of", "all the selected", "custom field options" ] }, "currency_field": { "name": "Currency Field", "type": "currency", "value": { "amount": 80000, "unit": "USD" } }, "compensation_field": { "name": "Compensation Field", "type": "currency", "value": { "amount": 80000, "unit": "USD" }, "compensation_type": "base", "frequency": "annually", "rationale": "base rationale" }, "currency_range_field": { "name": "Currency Range Field", "type": "currency_range", "value": { "min_value": 80000, "max_value": 150000, "unit": "USD" } }, "number_field": { "name": "Number Field", "type": "number", "value": 125 }, "number_range_field": { "name": "Number Range Field", "type": "number_range", "value": { "min_value": 80000, "max_value": 150000 } }, "date_field": { "name": "Date Field", "type": "date", "value": "YYYY-MM-DD" }, "url_field": { "name": "URL Field", "type": "url", "value": "https://www.thisisjustatextvalue.com" }, "user_field": { "name": "User Field", "type": "user", "value": { "user_id": 94354, "name": "Ben Smith", "email": "ben@example.com", "employee_id": "bs0615" } } } } </code></pre></div> Custom fields may be attached to several objects within the Greenhouse Recruiting system. These fields may appear on candidates, applications, offers, and other objects in the system. These fields share several properties and are always indicated in webhooks by the "custom_fields" element. However, the "value" attribute of custom fields are different depending on the "type" attribute, so you must check the "type" attribute in order to predict what will be included in the value "attribute". As described in the previous section, the type attribute will be one of short_text, long_text, boolean, single_select, multi_select, currency, currency_range, number, number_range, date, url, or user. An example of each of these fields' expected value format are provided. Compensation Field is a special type of <code>currency</code> custom field. If a currency field is marked as a compensation field, three additional fields will be included: <code>compensation_type</code>, <code>rationale</code>, <code>frequency</code> <h2 id='disabled-webhooks'>Disabled webhooks</h2> If a webhook is disabled, it will not trigger when the event occurs. Webhooks become disabled automatically if a ping event fails on create or update. They need to be manually re-enabled if this occurs. <h2 id='retry-policy'>Retry policy</h2> In the event of a failed webhook request (due to timeout, a non HTTP 200 response, or network issues), Greenhouse will make up to 7 attempts over the course of 15 hours. The table below outlines the estimated wait time for each attempt. <table><thead> <tr> <th style="text-align: left">Approx. Total waiting time</th> <th style="text-align: center">Attempt number</th> <th style="text-align: left">Next Attempt in</th> </tr> </thead><tbody> <tr> <td style="text-align: left">0h 0m</td> <td style="text-align: center">1</td> <td style="text-align: left">1m</td> </tr> <tr> <td style="text-align: left">0h 1m</td> <td style="text-align: center">2</td> <td style="text-align: left">15m</td> </tr> <tr> <td style="text-align: left">0h 16m</td> <td style="text-align: center">3</td> <td style="text-align: left">60m</td> </tr> <tr> <td style="text-align: left">1h 16m</td> <td style="text-align: center">4</td> <td style="text-align: left">120m</td> </tr> <tr> <td style="text-align: left">3h 16m</td> <td style="text-align: center">5</td> <td style="text-align: left">240m</td> </tr> <tr> <td style="text-align: left">7h 16m</td> <td style="text-align: center">6</td> <td style="text-align: left">480m</td> </tr> <tr> <td style="text-align: left">15h 16m</td> <td style="text-align: center">7</td> <td style="text-align: left">--</td> </tr> </tbody></table> <h1 id='application-events'>Application Events</h1><h2 id='application-created'>Application created</h2><div class="highlight"><pre class="highlight json tab-json"><code>{ "action": "new_candidate_application", "payload": { "application": { "id": 71980812, "rejected_at": null, "prospect": false, "status": "active", "applied_at": "2017-10-27T14:44:43Z", "last_activity_at": "2017-10-27T14:44:42Z", "url": "http://app.greenhouse.io/people/60304594?application_id=71980812", "source": { "id": 16, "name": "LinkedIn (Prospecting)" }, "credited_to": { "id": 92120, "email": "test123@example.com", "name": "Greenhouse Admin", "employee_id": "123ABC" }, "rejection_reason": null, "rejection_details": null, "current_stage": { "id": 2944102, "name": "Preliminary Phone Screen", "interviews": [ { "id": 4368004, "name": "Preliminary Screening Call", "status": "to_be_scheduled", "interview_kit": { "url": "http://app.greenhouse.io/guides/4368142/people/60304594?application_id=71980812", "content": "Directions on how to conduct this interview.", "questions": [ { "id": 3136352, "question": "Could you tell me about your previous experience?" }, { "id": 3136353, "question": "Why do you want to work with us?" } ] }, "interviewers": [] } ] }, "prospect_detail": { "prospect_pool": null, "prospect_stage": null, "prospect_owner": null }, "custom_fields": { "application_custom_test": { "name": "Application Custom Test", "type": "single_select", "value": null }, "custom_boolean_test": { "name": "Custom Boolean Test", "type": "boolean", "value": null } }, "candidate": { "id": 60304594, "first_name": "Jane", "last_name": "Smith", "title": "Manager", "company": "Current Company Co.", "created_at": "2017-10-27T14:44:42Z", "external_id": null, "photo_url": null, "url": "http://app.greenhouse.io/people/60304594", "is_private": false, "can_email": true, "phone_numbers": [ { "value": "555-555-5555", "type": "mobile" } ], "email_addresses": [ { "value": "person@work.com", "type": "work" }, { "value": "person@example.com", "type": "personal" } ], "addresses": [ { "value": "123 Test Street\nNew York, NY 10001", "type": "home" } ], "website_addresses": [ { "value": "mysite.com", "type": "personal" } ], "social_media_addresses": [ { "value": "socialmedia.com" } ], "educations": [ { "school_name": "Stanford University", "degree": "Bachelor's Degree", "discipline": "Computer Science", "start_date": "09/15/2007", "end_date": "05/15/2011" } ], "employments": [], "recruiter": { "id": 92121, "email": "employee@test.com", "name": "Betty Smith", "employee_id": "123ABC" }, "coordinator": { "id": 92427, "email": "user@example.com", "name": "Bonnie Bonnet", "employee_id": "456DEF" }, "attachments": [ { "filename": "Test Cover Letter.docx", "url": "https://prod-heroku.s3.amazonaws.com/...", "type": "cover_letter" }, { "filename": "Test Resume.docx", "url": "https://prod-heroku.s3.amazonaws.com/...", "type": "resume" } ], "tags": [ "Ruby", "Comp Sci" ], "custom_fields": { "date_test": { "name": "Date Test", "type": "date", "value": "" }, "desired_salary": { "name": "Desired Salary", "type": "short_text", "value": null }, "graduation_year_1": { "name": "Graduation Year", "type": "single_select", "value": null }, "work_remotely": { "name": "Work Remotely", "type": "boolean", "value": null } } }, "jobs": [ { "id": 274075, "name": "Data Scientist", "requisition_id": "ABC", "notes": null, "confidential": false, "job_post_id": 263533, "status": "open", "created_by_id": 273555, "created_at": "2016-07-14T17:21:30Z", "opened_at": "2016-07-20T16:00:00Z", "closed_at": null, "url": "http://app.greenhouse.io/sdash/274075", "departments": [ { "id": 8717, "name": "Data Science", "external_id": "ex-dept-1" } ], "offices": [ { "id": 16478, "name": "London", "location": "London, United Kingdom", "external_id": "ex-office-1" } ], "hiring_team": { "hiring_managers": [ { "user_id": 92913, "employee_id": "123ABC" } ], "sourcers": [ { "user_id": 92427, "employee_id": null } ], "recruiters": [ { "user_id": 92427, "employee_id": null } ], "coordinators": [ { "user_id": 92427, "employee_id": "DEFG123" } ] }, "custom_fields": { "date_test": { "name": "Date Test", "type": "date", "value": "2017-10-27" }, "employment_type": { "name": "Employment", "type": "single_select", "value": "Full-time" }, "replacement_role_": { "name": "Replacement Role", "type": "boolean", "value": true }, "salary_range_2": { "name": "Salary Range", "type": "currency_range", "value": { "unit": null, "min_value": "10000.0", "max_value": "10000.0" } }, "test_field_1": { "name": "Test Short Text Field", "type": "short_text", "value": "test" }, "test_user_field": { "name": "Test User Field", "type": "user", "value": { "user_id": 117730, "name": "Job Admin", "email": "asegal+jobadmin@greenhouse.io", "employee_id": "user-abc" } } } } ] } } } </code></pre></div> The New Candidate Application event occurs when a new application is created for a candidate. See webhook <a href="#common-attributes">common attributes</a>. <h2 id='application-deleted'>Application deleted</h2> This webhook only fires when individual applications are destroyed. This occurs when the Harvest API delete endpoint is used, when a candidate is removed from a specific job, or when two duplicate candidates on the same job are merged together. This will not fire when a candidate is deleted. A candidate being deleted implies all their applications have been deleted with them. <div class="highlight"><pre class="highlight json tab-json"><code>{ "action": "delete_application", "payload": { "application": { "id": 46194062, "candidate_id": 37031511, "job_id": 371417, "created_at": "2013-03-22T00:00:00Z", "source_id": 2, "candidate_rejection_reason_id": null, "rejection_note_id": 123, "rejected_at": "2014-04-22T01:00:00Z", "referrer_id": 158104, "prospect": false, "rejected_by_user_id": 158103 } } } </code></pre></div><h3 id='noteworthy-response-attributes'>Noteworthy response attributes</h3> <table><thead> <tr> <th>Attribute</th> <th>Note</th> </tr> </thead><tbody> <tr> <td><code>rejected_by_user_id</code></td> <td>The Greenhouse user who rejected this application, if the application is rejected.</td> </tr> </tbody></table> <h2 id='application-updated'>Application updated</h2><div class="highlight"><pre class="highlight json tab-json"><code>{ "action": "application_updated", "payload": { "application": { "id": 22202940, "rejected_at": null, "prospect": false, "prospect_detail": { "prospect_owner": null, "prospect_pool": null, "prospect_stage": null }, "status": "active", "applied_at": "2015-12-03T06:31:26Z", "last_activity_at": "2015-12-03T06:31:26Z", "url": "https://app.greenhouse.io/people/13857579?application_id=22202940", "source": { "id":2, "name": "Jobs page on your website" }, "credited_to": { "id": 3695, "email": "beauregard.blacksmith.3695@example.com", "name": "Beauregard Blacksmith", "employee_id": "123ABC" }, "rejection_reason": null, "rejection_details": null, "current_stage": { "id": 711020, "name": "Application Review", "interviews": [ { "id": 1063685, "name": "Application Review", "status": "collect_feedback", "interview_kit": { "url": "http://app.greenhouse.io/guides/1063859/people/13857579", "content": "", "questions":[] }, "interviewers": [] } ] }, "custom_fields": { "custom_application_field": { "name": "Custom Application Field", "type": "short_text", "value": "Example" } }, "candidate": { "id": 13857579, "first_name": "Hank", "last_name": "Von Diablo", "title": null, "company": null, "created_at": "2015-12-03T06:31:26Z", "external_id": null, "photo_url": null, "url": "https://app.greenhouse.io/people/13857579", "is_private": false, "can_email": true, "phone_numbers": [ { "value": "330-281-8004", "type": "other " } ], "email_addresses": [ { "value": "hank.von diablo.13857579@example.com", "type": "personal" } ], "addresses": [], "website_addresses": [ { "value": "http://www.example.com/", "type": "other" } ], "social_media_addresses": [ { "value": "https://twitter.com/TheRock" } ], "educations": [], "recruiter":null, "coordinator": null, "attachments":[], "tags":[], "custom_fields": { "current_salary": { "name": "Current Salary", "type": "short_text", "value": null }, "desired_salary": { "name": "Desired Salary", "type": "short_text", "value":null } } }, "jobs": [] } } } </code></pre></div> The Application Updated event occurs when an application is updated. See webhook <a href="#common-attributes">common attributes</a>. <h2 id='offer-created'>Offer created</h2> This webhook fires when creating a new offer in Greenhouse. This may also fire when changing an offer if the change causes a new version to be created. When bulk creating offers, this will fire per offer created. <div class="highlight"><pre class="highlight json tab-json"><code>{ "action": "offer_created", "payload": { "id": 12345, "application_id": 234556, "job_id": 45678, "user_id": 67890, "version": 1, "sent_on": "2013-03-22", "resolved_at": "2013-03-25T00:00:00Z", "start_date": "04/15/2013", "notes": "Vacation scheduled 4/20 - 4/23", "offer_status": "Accepted", "custom_fields": { "custom_application_field": { "name": "Custom Application Field", "type": "short_text", "value": "Example" } } } } </code></pre></div><h2 id='offer-approved'>Offer approved</h2> This webhook fires when an offer requires approval and the approval is received. <div class="highlight"><pre class="highlight json tab-json"><code>{ "action": "offer_approved", "payload": { "id": 12345, "application_id": 234556, "job_id": 45678, "user_id": 67890, "version": 1, "sent_on": "2013-03-22", "resolved_at": "2013-03-25T00:00:00Z", "start_date": "04/15/2013", "notes": "Vacation scheduled 4/20 - 4/23", "offer_status": "Accepted", "custom_fields": { "custom_application_field": { "name": "Custom Application Field", "type": "short_text", "value": "Example" } } } } </code></pre></div><h2 id='offer-updated'>Offer updated</h2> This webhook fires when an offer is updated. In some cases, an offer may be changed without generating a new version. In that case, this will fire by itself. If a change causes a new offer version to be generated, this will fire on the old version with the update to deprecate this offer and also a new "create" webhook will fire for the new version. This webhook should also fire when a person is hired, which marks the offer as "accepted." <div class="highlight"><pre class="highlight json tab-json"><code>{ "action": "offer_updated", "payload": { "id": 12345, "application_id": 234556, "job_id": 45678, "user_id": 67890, "version": 2, "sent_on": "2013-03-22", "resolved_at": "2013-03-25T00:00:00Z", "start_date": "04/15/2013", "notes": "Vacation scheduled 4/20 - 4/23", "offer_status": "Deprecated", "custom_fields": { "custom_application_field": { "name": "Custom Application Field", "type": "short_text", "value": "Example" } } } } </code></pre></div><h2 id='offer-deleted'>Offer deleted</h2> This webhook only fires when offers are deleted from the Greenhouse system. This only happens when the "Delete" link is clicked on an individual offer or when the anonymize candidate process is run with the "all_offer_versions" option selected. This will not fire individually when an application is deleted. <div class="highlight"><pre class="highlight json tab-json"><code>{ "action": "offer_deleted", "payload": { "offer": { "id": 506406, "application_id": 46194062, "offering_user_id": 158104, "offer_status": "Created", "version": 1, "sent_on": "2013-03-22", "resolved_at": "2013-03-25T00:00:00Z", "notes": "These are notes on the offer.", "job_id": 371417 } } } </code></pre></div><h3 id='noteworthy-response-attributes-2'>Noteworthy response attributes</h3> <table><thead> <tr> <th>Attribute</th> <th>Note</th> </tr> </thead><tbody> <tr> <td><code>offer_status</code></td> <td>One of Created, Accepted, Rejected, or Deprecated.</td> </tr> <tr> <td><code>version</code></td> <td>This is the version of the offer in Greenhouse. New versions are triggered when certain fields are updated.</td> </tr> <tr> <td><code>sent_on</code></td> <td>When the offer was sent to the candidate</td> </tr> <tr> <td><code>resolved_at</code></td> <td>When this version was either accepted, rejected, or deprecated (a new version was made)</td> </tr> </tbody></table> <h2 id='prospect-created'>Prospect created</h2><div class="highlight"><pre class="highlight json tab-json"><code>{ "action": "new_prospect_application", "payload": { "application": { "id": 979554, "rejected_at": null, "prospect": true, "status": "active", "applied_at": "2014-12-02T23:10:16Z", "last_activity_at": "2014-12-02T23:10:16Z", "url": "https://app.greenhouse.io/people/968190?application_id=979554", "source": { "id": 13, "public_name": "Referral" }, "credited_to": { "id": 2622, "email": "carl.buddha.2622@example.com", "name": "Carl Buddha", "employee_id": "123ABC" }, "rejection_reason": null, "rejection_details": null, "current_stage": null, "custom_fields": { "custom_application_field": { "name": "Custom Application Field", "type": "short_text", "value": null } }, "candidate": { "id": 968190, "first_name": "Trisha", "last_name": "Troy", "title": null, "company": null, "created_at": "2014-12-02T23:10:16Z", "external_id": null, "photo_url": null, "is_private": false, "can_email": true, "phone_numbers": [ { "value": "123456", "type": "other" } ], "email_addresses": [ { "value": "t.troy@example.com", "type": "personal" } ], "addresses": [], "website_addresses": [], "social_media_addresses": [], "educations": [ { "school_name": "Harvard University", "degree": "Bachelor's Degree", "discipline": "Information Systems", "start_date": "01/01/2012", "end_date": "01/01/2016" } ], "employments": [ { "company_name": "Greenhouse", "title": "Engineer", "start_date": "01/01/2012", "end_date": "01/01/2016" } ], "recruiter": { "id": 3128, "email": "alicia.flopple.3128@example.com", "name": "Alicia Flopple", "employee_id": "456DEF" }, "coordinator": null, "attachments": [ { "filename": "resume.pdf", "url": "https://prod-heroku.s3.amazonaws.com/...", "type": "resume" } ], "tags": [ "Import from Previous ATS" ], "custom_fields": { "favorite_color": { "name": "Favorite Color", "type": "short_text", "value": "Blue" } } }, "jobs": [ { "id": 371417, "name": "Designer", "requisition_id": null, "notes": "Digital and print", "confidential": false, "job_post_id": 54321, "status": "open", "created_by_id": 273555, "created_at": "2013-10-02T22:59:29Z", "opened_at": "2015-01-23T00:25:04Z", "closed_at": null, "departments": [ { "id": 237, "name": "Community", "external_id": "ex-dept-1" } ], "offices": [ { "id": 54, "name": "New York", "location": "New York, NY", "external_id": "ex-office-1" } ], "custom_fields": { "employment_type": { "name": "Employment Type", "type": "single_select", "value": "Full Time" } } } ] } } } </code></pre></div> The New Prospect Application event occurs when a new prospect application is created. See webhook <a href="#common-attributes">common attributes</a>. <h1 id='candidate-events'>Candidate Events</h1><h2 id='candidate-deleted'>Candidate deleted</h2> This webhook will fire when a candidate or prospect is deleted from Greenhouse. This occurs when the Harvest delete candidate methods are used, when a candidate is merged into another candidate, when a candidate is deleted in the application, and once for each candidate in a bulk delete operation. Deleting a candidate will cause other deletes within Greenhouse but we will not fire an individual webhook for those deletions. In the case of the applications that this delete causes, we will include an array of those Application IDs that will be removed from Greenhouse. <div class="highlight"><pre class="highlight json tab-json"><code>{ "action": "delete_candidate", "payload": { "person": { "id": 37031511, "first_name": "Jack", "last_name": "Sparrow", "company": "Pirate Shipping", "title": "Captain", "created_at": "2013-03-22T00:00:00Z", "headline": "Eager to find a new commission", "is_private": false, "recruiter_user_id": 123, "coordinator_user_id": 456, "can_email": false, "deleted_application_ids": [ 46196263, 46196258 ] } } } </code></pre></div><h3 id='noteworthy-response-attributes'>Noteworthy response attributes</h3> <table><thead> <tr> <th>Attribute</th> <th>Note</th> </tr> </thead><tbody> <tr> <td><code>is_private</code></td> <td>True or false; if this candidate has been marked private in Greenhouse.</td> </tr> <tr> <td><code>recruiter_user_id</code></td> <td>The Greenhouse user_id of this candidate's recruiter</td> </tr> <tr> <td><code>coordinator_user_id</code></td> <td>The Greenhouse user_id of this candidate's coordinator</td> </tr> <tr> <td><code>can_email</code></td> <td>True or false; if this candidate can be e-mailed.</td> </tr> <tr> <td><code>application_ids</code></td> <td>This is an array containing the Greenhouse application IDs that will be deleted as a consequence of this candidate being deleted</td> </tr> <tr> <td><code>deleted_application_ids</code></td> <td>In many merge cases, this section will be blank, as applications will have been merged into the new candidate.</td> </tr> </tbody></table> <h2 id='candidate-hired'>Candidate hired</h2><div class="highlight"><pre class="highlight json tab-json"><code>{ "action": "hire_candidate", "payload": { "application": { "id": 46194062, "opening": { "opening_id": "1234-56", "custom_fields": [] }, "credited_to": { "id": 158104, "email": "bob_johnson1@localhost.com", "name": "Robert Johnson", "employee_id": "123ABC" }, "source": { "id": 25, "public_name": "Monster" }, "url": "https://app.greenhouse.io/people/35897443?application_id=46194062", "candidate": { "id": 35897443, "first_name": "Johnny", "last_name": "Smith", "title": "Previous Title", "external_id": "12345", "url": "https://app.greenhouse.io/people/35897443", "is_private": false, "can_email": true, "phone_numbers": [ { "value": "518-555-1212", "type": "work" }, { "value": "212-555-1212", "type": "home" } ], "email_addresses": [ { "value": "personal@example.com", "type": "personal" }, { "value": "work@example.com", "type": "work" } ], "addresses": [ { "value": "455 Broadway New York, NY 10280", "type": "home" } ], "educations": [ { "school_name": "Harvard University", "degree": "Bachelor's Degree", "discipline": "Information Systems", "start_date": "01/01/2012", "end_date": "01/01/2016" } ], "employments": [ { "company_name": "Greenhouse", "title": "Engineer", "start_date": "01/01/2012", "end_date": "01/01/2016" } ], "recruiter": { "id": 55, "email": "bob_johnson@localhost.com", "name": "Bob Johnson", "employee_id": "456DEF" }, "coordinator": { "id": 56, "email": "bob_johnson_approver1@localhost.com", "name": "Robert J Approver", "employee_id": "789GHI" }, "attachments": [ { "filename": "resume.pdf", "url": "https://prod-heroku.s3.amazonaws.com/...", "type": "resume" } ], "custom_fields": { "desired_level": { "name": "Desired Level", "type": "short_text", "value": "Senior" }, "favorite_programming_language": { "name": "Favorite Programming Language", "type": "short_text", "value": "Rails" } } }, "job": { "id": 323753, "name": "Developer", "open_date": "2014-11-20T22:49:14Z", "close_date": "2014-11-25T22:49:14Z", "requisition_id": null, "departments": [ { "id": 7, "name": "Technology", "external_id": "ex-dept-1" } ], "offices": [ { "id": 13, "name": "New York City", "location": "New York, NY", "external_id": "ex-office-1" }, { "id": 14, "name": "St. Louis", "location": null, "external_id": null } ], "custom_fields": { "approved": { "name": "Approved", "type": "boolean", "value": true }, "employment_type": { "name": "Employment Type", "type": "single_select", "value": "Full-time" }, "salary_range": { "name": "SalaryRange", "type": "currency_range", "value": { "unit": "USD", "min_value": "10000.0", "max_value": "20000.0" } } } }, "jobs": [ { "id": 323753, "name": "Developer", "requisition_id": null, "confidential": false, "opened_at": "2014-11-20T22:49:14Z", "closed_at": "2014-11-25T22:49:14Z", "departments": [ { "id": 7, "name": "Technology", "external_id": "ex-dept-1" } ], "offices": [ { "id": 13, "name": "New York City", "location": "New York, NY", "external_id": "ex-office-1" }, { "id": 14, "name": "St. Louis", "location": null, "external_id": null } ], "custom_fields": { "approved": { "name": "Approved", "type": "boolean", "value": true }, "employment_type": { "name": "Employment Type", "type": "single_select", "value": "Full-time" }, "salary_range": { "name": "SalaryRange", "type": "currency_range", "value": { "unit": "USD", "min_value": "10000.0", "max_value": "20000.0" } } } } ], "custom_fields": { "custom_application_field": { "name": "Custom Application Field", "type": "short_text", "value": "Example123" } }, "offer": { "id": 506409, "version": 2, "created_at": "2014-11-20T22:49:14Z", "sent_at": "2014-11-10", "resolved_at": "2014-11-20T22:49:14Z", "starts_at": "2015-01-23", "custom_fields": { "salary": { "name": "Salary", "type": "currency", "value": { "amount": 80000, "unit": "USD" } }, "seasons": { "name": "Seasons", "type": "multi_select", "value": [ "Season 1", "Season 2" ] } } } } } } </code></pre></div> The Hire Candidate event occurs when an offer is accepted. This is triggered by clicking the "Accept Offer" button on the candidate's Private tab. <h3 id='noteworthy-attributes'>Noteworthy attributes</h3> See webhook <a href="#common-attributes">common attributes</a>. <table><thead> <tr> <th>Attribute</th> <th>Note</th> </tr> </thead><tbody> <tr> <td><code>application.offer.id</code></td> <td>Unique Greenhouse identifier of the offer. Information not included in the webhook can be retrieved via <a href="harvest.html#offers">Harvest API - GET Offers</a></td> </tr> <tr> <td><code>application.offer.created_at</code></td> <td>Date when this offer was drafted.</td> </tr> <tr> <td><code>application.offer.sent_on</code></td> <td>Date when this offer was sent to the candidate.</td> </tr> <tr> <td><code>application.offer.resolved_at</code></td> <td>Date the offer was accepted.</td> </tr> <tr> <td><code>application.offer.starts_at</code></td> <td>The candidate's start date. Expected format is YYYY-MM-DD</td> </tr> <tr> <td><code>application.job</code></td> <td>Deprecated. Use <code>application.jobs[]</code> instead</td> </tr> <tr> <td><code>application.job.close_date</code></td> <td>Deprecated. Use <code>application.jobs[].closed_at</code> instead.</td> </tr> <tr> <td><code>application.job.open_date</code></td> <td>Deprecated. Use <code>application.jobs[].opened_at</code> instead.</td> </tr> <tr> <td><code>application.opening.custom_fields</code></td> <td>This element may be omitted if the organization does not have custom fields for openings enabled.</td> </tr> </tbody></table> <h2 id='candidate-merged'>Candidate merged</h2> This webhook will fire when a candidate or prospect is merged with another candidate. This process should fire for regular manual merges and auto-merges. It will also fire per candidate for a bulk merge. This webhook supersedes the candidate deleted webhook. If both candidate deleted and candidate merged are configured on your site, only the candidate merged webhook will fire when candidate records are removed via merge. If a candidate deleted webhook is configured but candidate merged is not, then the candidate deleted webhook will fire when a candidate record is deleted via merge. The payload for a candidate merged webhook matches the payload for candidate deleted except it contains the ID of the winning candidate record. <div class="highlight"><pre class="highlight json tab-json"><code>{ "action": "merge_candidate", "payload": { "person": { "id": 37031511, "first_name": "Jack", "last_name": "Sparrow", "company": "Pirate Shipping", "title": "Captain", "created_at": "2013-03-22T00:00:00Z", "headline": "Eager to find a new commission", "is_private": false, "recruiter_user_id": 123, "coordinator_user_id": 456, "can_email": false, "new_candidate_id": 457456 } } } </code></pre></div><h3 id='noteworthy-response-attributes-2'>Noteworthy response attributes</h3> <table><thead> <tr> <th>Attribute</th> <th>Note</th> </tr> </thead><tbody> <tr> <td><code>new_candidate_id</code></td> <td>The ID of the candidate to whom this candidate has been merged</td> </tr> </tbody></table> <h2 id='candidate-stage-change'>Candidate stage change</h2><div class="highlight"><pre class="highlight json tab-json"><code>{ "action": "candidate_stage_change", "payload": { "application": { "id": 265277, "rejected_at": null, "prospect": false, "status": "active", "applied_at": "2013-03-22T00:00:00Z", "last_activity_at": "2015-02-09T16:38:36Z", "url": "https://app.greenhouse.io/people/265772?application_id= 265277", "source": { "id": 31, "name": "Agency" }, "credited_to": { "id": 15, "email": "ada@example.com", "name": "Ada Lacey", "employee_id": "123ABC" }, "rejection_reason": null, "rejection_details": null, "current_stage": { "id": 71416, "name": "Assessment", "interviews": [ { "id": 113101, "name": "Assessment", "status": "to_be_scheduled", "interview_kit": { "url": "https://app.greenhouse.io/guides/113153/people/265772", "content": "Assess their skills", "questions": [] }, "interviewers": [ { "id": 2622, "display_name": "Carl Buddha", "status": "tentative" } ] } ] }, "custom_fields": { "custom_application_field": { "name": "Custom Application Field", "type": "short_text", "value": "Example" } }, "candidate": { "id": 265772, "first_name": "Giuseppe", "last_name": "Hurley", "title": "Great Person", "company": null, "created_at": "2013-10-04T01:24:44Z", "external_id": "241b399ce4b0fd1c84e5528d", "photo_url": null, "url": "https://app.greenhouse.io/people/265772", "is_private": false, "can_email": true, "phone_numbers": [ { "value": "330-281-8004", "type": "home" } ], "email_addresses": [ { "value": "giuseppe.hurley@example.com", "type": "personal" } ], "addresses": [ { "value": "123 Fake St.", "type": "home" } ], "website_addresses": [ { "value": "ghurley.example.com", "type": "personal" } ], "social_media_addresses": [ { "value": "linkedin.example.com/ghurley" } ], "educations": [ { "school_name": "Harvard University", "degree": "Bachelor's Degree", "discipline": "Information Systems", "start_date": "01/01/2012", "end_date": "01/01/2016" } ], "employments": [ { "company_name": "Greenhouse", "title": "Engineer", "start_date": "01/01/2012", "end_date": "01/01/2016" } ], "recruiter": { "id": 3128, "email": "alicia.flopple.3128@example.com", "name": "Alicia Flopple", "employee_id": "789GHI" }, "coordinator": { "id": 3128, "email": "alicia.flopple.3128@example.com", "name": "Alicia Flopple", "employee_id": "789GHI" }, "attachments": [ { "filename": "resume.pdf", "url": "https://prod-heroku.s3.amazonaws.com/...", "type": "resume" }, { "filename": "cover_letter.pdf", "url": "https://prod-heroku.s3.amazonaws.com/...", "type": "cover_letter" }, { "filename": "portfolio.pdf", "url": "https://prod-heroku.s3.amazonaws.com/...", "type": "attachment" } ], "tags": [ "Import from Previous ATS" ], "custom_fields": { "favorite_color": { "name": "Favorite Color", "type": "short_text", "value": "Blue" } } }, "jobs": [ { "id": 3485, "name": "Designer", "requisition_id": null, "notes": "Digital and print", "confidential": false, "job_post_id": 553282, "status": "open", "created_by_id": 273555, "created_at": "2013-10-02T22:59:29Z", "opened_at": "2015-01-23T00:25:04Z", "closed_at": null, "departments": [ { "id": 237, "name": "Community", "external_id": "ex-dept-1" } ], "offices": [ { "id": 54, "name": "New York", "location": "New York, NY", "external_id": "ex-office-1" } ], "custom_fields": { "employment_type": { "name": "Employment Type", "type": "single_select", "value": "Full Time" } } } ] } } } </code></pre></div><h3 id='noteworthy-response-attributes-3'>Noteworthy response attributes</h3> See webhook <a href="#common-attributes">common attributes</a>. <table><thead> <tr> <th>Attribute</th> <th>Note</th> </tr> </thead><tbody> <tr> <td><code>application.current_stage.interviews[].interviewers.status</code></td> <td>One of: <code>needs_action</code>, <code>declined</code>, <code>tentative</code>, <code>accepted</code></td> </tr> <tr> <td><code>application.current_stage.interviews[].status</code></td> <td>One of: <code>to_be_scheduled</code>, <code>scheduled</code>, <code>awaiting_feedback</code>, <code>complete</code>, <code>skipped</code>, <code>collect_feedback</code>, <code>to_be_sent</code>, <code>sent</code>, <code>received</code></td> </tr> </tbody></table> <h2 id='candidate-unhired'>Candidate unhired</h2><div class="highlight"><pre class="highlight json tab-json"><code>{ "action": "unhire_candidate", "payload": { "application": { "id": 265293, "rejected_at": null, "prospect": false, "status": "active", "applied_at": "2013-03-22T00:00:00Z", "last_activity_at": "2015-03-18T20:28:09Z", "url": "https://app.greenhouse.io/people/265788?application_id=265293", "source": { "id": 27, "public_name": "LinkedIn" }, "credited_to": null, "rejection_reason": null, "rejection_details": null, "current_stage": { "id": 678901, "name": "Application Review", "interviews": [ { "id": 989099, "name":"Application Review", "status": "collect_feedback", "interview_kit": { "url": "http://app.greenhouse.io/guides/67656/people/265788", "content": "", "questions": [] }, "interviewers": [] } ] }, "custom_fields": { "custom_application_field": { "name": "Custom Application Field", "type": "short_text", "value": null } }, "candidate": { "id": 265788, "first_name": "Hector", "last_name": "Porter", "title": null, "company": null, "created_at": "2013-10-04T01:24:48Z", "external_id": null, "photo_url": null, "url": "https://app.greenhouse.io/people/265788", "is_private": false, "can_email": true, "phone_numbers": [ { "value": "330-281-8004", "type": "home" } ], "email_addresses": [ { "value": "hector.porter.265788@example.com", "type": "personal" } ], "addresses": [], "website_addresses": [], "social_media_addresses": [], "educations": [ { "school_name": "Harvard University", "degree": "Bachelor's Degree", "discipline": "Information Systems", "start_date": "01/01/2012", "end_date": "01/01/2016" } ], "employments": [ { "company_name": "Greenhouse", "title": "Engineer", "start_date": "01/01/2012", "end_date": "01/01/2016" } ], "recruiter": null, "coordinator": null, "attachments": [ { "filename": "resume.pdf", "url": "https://prod-heroku.s3.amazonaws.com/...", "type": "resume" } ], "tags": [ "Import from Previous ATS" ], "custom_fields": { "favorite_color": { "name": "Favorite Color", "type": "short_text", "value": "Blue" } } }, "jobs": [ { "id": 371417, "name": "Designer", "requisition_id": null, "notes": "Digital and print", "confidential": false, "job_post_id": 54321, "status": "open", "created_by_id": 273555, "created_at": "2013-10-02T22:59:29Z", "opened_at": "2015-01-23T00:25:04Z", "closed_at": null, "departments": [ { "id": 14501, "name": "Community", "external_id": "ex-dept-1" } ], "offices": [ { "id": 9099, "name": "New York", "location": "New York, NY", "external_id": "ex-office-1" } ], "custom_fields": { "employment_type": { "name": "Employment Type", "type": "single_select", "value": "Full Time" } } } ] } } } </code></pre></div> This webhook only fires when the "Unhire" button is clicked in Greenhouse. This button is only available on the candidate profile page after a candidate has been hired. See webhook <a href="#common-attributes">common attributes</a>. <h2 id='candidate-prospect-rejected'>Candidate/Prospect rejected</h2><div class="highlight"><pre class="highlight json tab-json"><code>{ "action": "reject_candidate", "payload": { "application": { "id": 265293, "rejected_at": "2015-02-11T15:50:41Z", "prospect": false, "status": "rejected", "applied_at": "2013-03-22T00:00:00Z", "last_activity_at": "2015-02-11T15:50:41Z", "url": "https://app.greenhouse.io/people/265788?application_id=265293", "source": { "id": 27, "public_name": "LinkedIn" }, "credited_to": null, "rejection_reason": { "id": 14, "name": "Too Junior", "type": { "id": 3, "name": "Wrong skill set" } }, "rejection_details": { "custom_fields": { "custom_rejection_question_field": { "name": "Custom Rejection Question Field", "type": "short_text", "value": "Example" } } }, "current_stage": { "id": 2708728, "name": "Offer", "interviews": [] }, "custom_fields": { "custom_application_field": { "name": "Custom Application Field", "type": "short_text", "value": "Example123" } }, "candidate": { "id": 265788, "first_name": "Hector", "last_name": "Porter", "title": null, "company": null, "created_at": "2013-10-04T01:24:48Z", "external_id": null, "photo_url": null, "is_private": false, "can_email": true, "phone_numbers": [ { "value": "330-281-8004", "type": "home" } ], "email_addresses": [ { "value": "hector.porter.265788@example.com", "type": "personal" } ], "addresses": [], "website_addresses": [], "social_media_addresses": [], "educations": [ { "school_name": "Harvard University", "degree": "Bachelor's Degree", "discipline": "Information Systems", "start_date": "01/01/2012", "end_date": "01/01/2016" } ], "employments": [ { "company_name": "Greenhouse", "title": "Engineer", "start_date": "01/01/2012", "end_date": "01/01/2016" } ], "recruiter": null, "coordinator": null, "attachments": [ { "filename": "resume.pdf", "url": "https://prod-heroku.s3.amazonaws.com/...", "type": "resume" } ], "tags": [ "Imported" ], "custom_fields": { "favorite_color": { "name": "Favorite Color", "type": "short_text", "value": "Blue" } } }, "jobs": [ { "id": 371417, "name": "Designer", "requisition_id": null, "notes": "Digital and print", "confidential": false, "job_post_id": 54321, "status": "open", "created_by_id": 273555, "created_at": "2013-10-02T22:59:29Z", "opened_at": "2015-01-23T00:25:04Z", "closed_at": null, "departments": [ { "id": 237, "name": "Community", "external_id": "ex-dept-1" } ], "offices": [ { "id": 9099, "name": "New York", "location": "New York, NY", "external_id": "ex-office-1" } ], "custom_fields": { "employment_type": { "name": "Employment Type", "type": "single_select", "value": "Full Time" } } } ] } } } </code></pre></div> The Reject Candidate event occurs when a prospect or candidate is rejected for a position. When candidates are rejected via a bulk action, a webhook will fire once for each candidate or prospect rejected. See webhook <a href="#common-attributes">common attributes</a>. <h2 id='candidate-prospect-unrejected'>Candidate/Prospect unrejected</h2><div class="highlight"><pre class="highlight json tab-json"><code>{ "action": "unreject_candidate", "payload": { "application": { "id": 265293, "rejected_at": null, "prospect": false, "status": "active", "applied_at": "2013-03-22T00:00:00Z", "last_activity_at": "2015-02-11T15:50:41Z", "url": "https://app.greenhouse.io/people/265788?application_id=265293", "source": { "id": 27, "public_name": "LinkedIn" }, "credited_to": null, "rejection_reason": null, "rejection_details": null, "current_stage": { "id": 2708728, "name": "Offer", "interviews": [] }, "custom_fields": { "custom_application_field": { "name": "Custom Application Field", "type": "short_text", "value": "Example123" } }, "candidate": { "id": 265788, "first_name": "Hector", "last_name": "Porter", "title": null, "company": null, "created_at": "2013-10-04T01:24:48Z", "external_id": null, "photo_url": null, "is_private": false, "can_email": true, "phone_numbers": [ { "value": "330-281-8004", "type": "home" } ], "email_addresses": [ { "value": "hector.porter.265788@example.com", "type": "personal" } ], "addresses": [], "website_addresses": [], "social_media_addresses": [], "educations": [ { "school_name": "Harvard University", "degree": "Bachelor's Degree", "discipline": "Information Systems", "start_date": "01/01/2012", "end_date": "01/01/2016" } ], "employments": [ { "company_name": "Greenhouse", "title": "Engineer", "start_date": "01/01/2012", "end_date": "01/01/2016" } ], "recruiter": null, "coordinator": null, "attachments": [ { "filename": "resume.pdf", "url": "https://prod-heroku.s3.amazonaws.com/...", "type": "resume" } ], "tags": [ "Imported" ], "custom_fields": { "favorite_color": { "name": "Favorite Color", "type": "short_text", "value": "Blue" } } }, "jobs": [ { "id": 371417, "name": "Designer", "requisition_id": null, "notes": "Digital and print", "confidential": false, "job_post_id": 54321, "status": "open", "created_by_id": 273555, "created_at": "2013-10-02T22:59:29Z", "opened_at": "2015-01-23T00:25:04Z", "closed_at": null, "departments": [ { "id": 237, "name": "Community", "external_id": "ex-dept-1" } ], "offices": [ { "id": 9099, "name": "New York", "location": "New York, NY", "external_id": "ex-office-1" } ], "custom_fields": { "employment_type": { "name": "Employment Type", "type": "single_select", "value": "Full Time" } } } ] } } } </code></pre></div> The Unreject Candidate event occurs when a prospect or candidate is unrejected. See webhook <a href="#common-attributes">common attributes</a>. <h2 id='candidate-prospect-updated'>Candidate/Prospect updated</h2><div class="highlight"><pre class="highlight json tab-json"><code>{ "action": "update_candidate", "payload": { "candidate": { "id": 15696179, "first_name": "Ronald", "last_name": "Ronnie", "title": "Director of Strategic Initiatives", "company": "Example", "created_at": "2016-08-23T17:51:27Z", "external_id": "946aa514658", "photo_url": null, "url": "https://app.greenhouse.io/people/15696179", "phone_numbers": [ { "value": "911", "type": "mobile" } ], "email_addresses": [ { "value": "123456email@email.com", "type": "work" } ], "addresses": [ { "value": "99-99 5th Ave.\nNew York, NY 101-11", "type": "home" } ], "website_addresses": [ { "value": "google.com", "type": "personal" } ], "social_media_addresses": [ { "value": "@ronaldronnie99999" } ], "educations": [ { "school_name": "Harvard University", "degree": "Bachelor's Degree", "discipline": "Information Systems", "start_date": "01/01/2012", "end_date": "01/01/2016" } ], "employments": [ { "company_name": "Greenhouse", "title": "Engineer", "start_date": "01/01/2012", "end_date": "01/01/2016" } ], "recruiter": { "id": 169779, "email": "hank.hollandaise.169779@example.com", "name": "Hank Hollandaise", "employee_id": "123ABC" }, "coordinator": { "id": 83637, "email": "sterling.kang.83637@example.com", "name": "Sterling Kang", "employee_id": "456DEF" }, "attachments": [ { "filename": "resumeA.pdf", "url": "https://prod-heroku.s3.amazonaws.com/...", "type": "resume" }, { "filename": "resumeB.pdf", "url": "https://prod-heroku.s3.amazonaws.com/...", "type": "resume" } ], "tags": [ "foo", "File Import" ], "custom_fields": { "current_salary": { "name": "Current Salary", "type": "short_text", "value": null }, "desired_salary": { "name": "Desired Salary", "type": "short_text", "value": null } } } } } </code></pre></div> The Candidate or Prospect Updated event occurs when a candidate or prospect's standard field or custom field is updated. For instance, an update to a candidate's first name would trigger this event. See webhook <a href="#common-attributes">common attributes</a>. <h2 id='candidate-anonymized'>Candidate anonymized</h2> This webhook will fire when a particular candidate receives an anonymize event. Anonymize events may occur from the <a href="#put-anonymize-candidate">Anonymize Endpoint</a> in Harvest or may be configured in the GDPR page in the Greenhouse application. An anonymize webhook consists of the action type, the id of the candidate who had properties anonymized, and the information that was anonymized. <div class="highlight"><pre class="highlight json tab-json"><code>{ "action": "candidate_anonymized", "payload": { "candidate_id": 37031511, "anonymized_fields": ["full_name", "current_title"] } } </code></pre></div><h3 id='anonymized-fields'>Anonymized Fields</h3> A list of possible anonymized fields are provided. If the item in "attribute" is received in the anonymized_fields array, the corresponding changes in notes have been applied in Greenhouse. Note that some of these fields may not be accessible via other webhooks or via Harvest. <table><thead> <tr> <th>Attribute</th> <th>Anonymize Process</th> </tr> </thead><tbody> <tr> <td><code>activity_items</code></td> <td>Destroy all items in the candidate's activity feed of type "activity". In Harvest's Activity Feed endpoint, these are items in the <code>activities</code> section.</td> </tr> <tr> <td><code>addresses</code></td> <td>Destroy all values from <code>candidate.addresses</code></td> </tr> <tr> <td><code>all_offer_versions</code></td> <td>For each of this candidate's applications, destroy all offers. (For legacy reasons, this will also raise an <a href="#offer-deleted">Offer Deleted</a> webhook if one is configured.)</td> </tr> <tr> <td><code>application_questions</code></td> <td>For each of this candidate's applications, destroy all values from <code>application.answers</code>.</td> </tr> <tr> <td><code>attachments</code></td> <td>Destroy all attachments on this candidate and all their associated applications.</td> </tr> <tr> <td><code>candidate_stage_data</code></td> <td>For each of this candidate's applications, set the <code>created_at</code> time to now, remove the candidate from the current stage, destroy all stage transition information, and set the candidate back to the first stage.</td> </tr> <tr> <td><code>coordinator</code></td> <td>Set <code>candidate.coordinator</code> to null</td> </tr> <tr> <td><code>credited_to</code></td> <td>For each of this candidate's application, destroy <code>application.credited_to</code>.</td> </tr> <tr> <td><code>custom_application_fields</code></td> <td>For each of this candidate's applications, destroy <code>application.custom_fields</code>.</td> </tr> <tr> <td><code>custom_candidate_fields</code></td> <td>Destroy all values from <code>candidate.custom_fields</code></td> </tr> <tr> <td><code>custom_rejection_question_fields</code></td> <td>For each of this candidate's application, destroy all custom fields on rejection details.</td> </tr> <tr> <td><code>current_company</code></td> <td>Set <code>candidate.company</code> to null.</td> </tr> <tr> <td><code>current_title</code></td> <td>Set <code>candidate.title</code> to null.</td> </tr> <tr> <td><code>education</code></td> <td>Remove all values from <code>candidate.educations</code></td> </tr> <tr> <td><code>email_addresses</code></td> <td>Destroy all values from <code>candidate.email_addresses</code></td> </tr> <tr> <td><code>employment</code></td> <td>Remove all values from <code>candidate.employments</code></td> </tr> <tr> <td><code>emails</code></td> <td>Destroy record of any e-mails sent to this candidate via Greenhouse.</td> </tr> <tr> <td><code>follow_up_reminders</code></td> <td>Destroy any follow-up reminders configured on this person.</td> </tr> <tr> <td><code>full_name</code></td> <td>Set <code>candidate.first_name</code> to "Anonymized" and <code>candidate.last_name</code> to the <code>candidate.id</code>.</td> </tr> <tr> <td><code>headline</code></td> <td>Set the candidate's headline to null.</td> </tr> <tr> <td><code>inmails</code></td> <td>Destroy record of any LinkedIn Inmails synced to this candidate from LinkedIn.</td> </tr> <tr> <td><code>innotes</code></td> <td>Destroy record of any LinkedIn Innotes synced to this candidate from LinkedIn.</td> </tr> <tr> <td><code>location</code></td> <td>For each of this candidate's applications, set <code>application.location</code> to null.</td> </tr> <tr> <td><code>notes</code></td> <td>Destroy all notes on this candidate.</td> </tr> <tr> <td><code>offers</code></td> <td>Destroy all information on all offers on any of this candidate's applications without destroying that an offer was made.</td> </tr> <tr> <td><code>phone_numbers</code></td> <td>Remove all values from <code>candidate.phone_numbers</code></td> </tr> <tr> <td><code>prospect_jobs</code></td> <td>Remove all associations between this prospect and jobs.</td> </tr> <tr> <td><code>prospect_offices</code></td> <td>Remove all associations between this prospect and offices.</td> </tr> <tr> <td><code>prospect_offices_and_departments</code></td> <td>Remove all associations between this prospect and departments.</td> </tr> <tr> <td><code>prospect_owner</code></td> <td>For each of this candidate's prospect applications, destroy the prospect owner.</td> </tr> <tr> <td><code>prospect_pool_and_stage</code></td> <td>For each of this candidate's application, destroy the prospect pool and the prospect pool stage.</td> </tr> <tr> <td><code>recruiter</code></td> <td>Set <code>candidate.recruiter</code> to null</td> </tr> <tr> <td><code>referral_questions</code></td> <td>Destroy all referral answers for this candidate.</td> </tr> <tr> <td><code>rejection_notes</code></td> <td>Destroy all notes specifically related to this candidate's rejection.</td> </tr> <tr> <td><code>rejection_reasons</code></td> <td>Set <code>rejection_reason</code> on all candidate applications to null.</td> </tr> <tr> <td><code>scorecards_and_interviews</code></td> <td>Destroy all scorecards with this candidate id and all interviews with any application from this candidate id</td> </tr> <tr> <td><code>social_media_links</code></td> <td>Remove all values from <code>candidate.social_media_addresses</code></td> </tr> <tr> <td><code>source</code></td> <td>Remove <code>application.source</code> in all this candidate's applications.</td> </tr> <tr> <td><code>tags</code></td> <td>Remove all values from <code>candidate.tags</code></td> </tr> <tr> <td><code>third_party_integrations</code></td> <td>Disconnect the candidate's profile from the LinkedIn CSA and RSC integrations.</td> </tr> <tr> <td><code>touchpoints</code></td> <td>Destroy all touchpoints on the candidate, all the candidate's applications, and any notes associated with touchpoints.</td> </tr> <tr> <td><code>websites</code></td> <td>Remove all values from <code>candidate.website_addresses</code></td> </tr> </tbody></table> <h1 id='interview-events'>Interview Events</h1><h2 id='interview-deleted'>Interview deleted</h2> This webhook fires when a scheduled interview is cancelled or the interview is deleted directly. This webhook will not fire if an interview is deleted because a candidate, application, or hiring plan is deleted. <div class="highlight"><pre class="highlight json tab-json"><code>{ "action": "interview_deleted", "payload": { "interview": { "id": 31087450 } } } </code></pre></div><h2 id='scorecard-deleted'>Scorecard deleted</h2> This webhook only fires when individual scorecards are destroyed. This occurs when the Harvest API delete endpoint is used, or when the delete scorecard link is used in the application. This will not fire when a candidate or application is deleted. A candidate being deleted implies all their scorecards have been deleted with them. An application being deleted does not cause scorecards to be deleted. <div class="highlight"><pre class="highlight json tab-json"><code>{ "action": "scorecard_deleted", "payload": { "scorecard": { "id": 6036088, "candidate_id": 29843272, "interviewed_at": "2016-12-28T17:00:00.000Z", "created_at": "2016-12-28T22:58:03.552Z", "updated_at": "2016-12-28T22:58:03.552Z", "scorecard_status": "complete" } } } </code></pre></div><h1 id='job-events'>Job Events</h1><h2 id='job-created'>Job created</h2><div class="highlight"><pre class="highlight json tab-json"><code>{ "action": "job_created", "payload": { "job": { "id": 371417, "name": "Software Engineer", "requisition_id": null, "notes": "Looking for the best!", "confidential": false, "job_post_id": 2154, "status": "open", "created_by_id": 273555, "created_at": "2016-10-20T18:16:32Z", "opened_at": "2016-10-20T18:16:32Z", "closed_at": null, "departments": [ { "id": 7, "name": "Technology", "external_id": "ex-dept-1" } ], "offices": [ { "id": 13, "name": "New York City", "location": "New York, NY", "external_id": "ex-office-1" }, { "id": 14, "name": "St. Louis", "location": null, "external_id": null } ], "hiring_team": { "hiring_managers": [ { "user_id": 1234, "employee_id": "abc-123" } ], "sourcers": [], "recruiters": [ { "user_id": 2345, "employee_id": null }, { "user_id": 3456, "employee_id": "abc-234" } ], "coordinators": [] }, "openings": [ { "id": 1234, "opening_id": "abc-1", "custom_fields": [] }, { "id": 1235, "opening_id": "abc-2", "custom_fields": [] } ], "custom_fields": { "approved": { "name": "Approved", "type": "boolean", "value": true }, "employment_type": { "name": "Employment Type", "type": "single_select", "value": "Full-time" }, "salary_range": { "name": "SalaryRange", "type": "currency_range", "value": { "unit": "USD", "min_value": "10000.0", "max_value": "20000.0" } } } } } } </code></pre></div> The Job Created event is triggered when a new job is created from scratch or copied from another job. <table><thead> <tr> <th>Attribute</th> <th>Note</th> </tr> </thead><tbody> <tr> <td><code>hiring_team</code></td> <td>Field contains the Greenhouse users responsible for this job. Each field contains the user's Greenhouse user id and the user's external employee id from the customer's system. The employee id will be null if it has not been set in Greenhouse.</td> </tr> <tr> <td><code>openings</code></td> <td>Field contains all the openings in this job. The custom field element on each opening may be omitted if the organization does not have custom fields on openings enabled.</td> </tr> </tbody></table> <h2 id='job-deleted'>Job deleted</h2> This webhook only fires when jobs are deleted from the Greenhouse system. This only happens when a job is closed and then the "Delete" button is clicked from the Job Dashboard. <div class="highlight"><pre class="highlight json tab-json"><code>{ "action": "job_deleted", "payload": { "job": { "id": 209256, "name": "Project Manager" } } } </code></pre></div><h3 id='noteworthy-response-attributes'>Noteworthy response attributes</h3> <table><thead> <tr> <th>Attribute</th> <th>Note</th> </tr> </thead><tbody> <tr> <td><code>id</code></td> <td>The internal Greenhouse Job id</td> </tr> <tr> <td><code>name</code></td> <td>The name of the job that was deleted</td> </tr> </tbody></table> <h2 id='job-updated'>Job updated</h2><div class="highlight"><pre class="highlight json tab-json"><code>{ "action": "job_updated", "payload": { "job": { "id": 100445, "name": "Assistant Store Manager, NYC", "requisition_id": null, "notes": "Looking for the best!<\/p>", "confidential": false, "job_post_id": 88010, "status": "open", "created_by_id": 273555, "created_at": "2015-08-11T23:02:09Z", "opened_at": "2015-08-11T23:02:09Z", "closed_at": null, "departments": [ { "id": 74, "name": "Guideshops", "external_id": "ex-dept-1" } ], "offices": [ { "id": 104, "name": "New York", "location": "New York, NY", "external_id": "ex-office-1" } ], "hiring_team": { "hiring_managers": [ { "user_id": 1234, "employee_id": "abc-123" } ], "sourcers": [], "recruiters": [ { "user_id": 2345, "employee_id": null }, { "user_id": 3456, "employee_id": "abc-234" } ], "coordinators": [] }, "openings": [ { "id": 1234, "opening_id": "abc-1", "custom_fields": [] }, { "id": 1235, "opening_id": "abc-2", "custom_fields": [] } ], "custom_fields": { "bonus": { "name": "Bonus", "type": "short_text", "value": null }, "employment_type": { "name": "Employment Type", "type": "single_select", "value": null }, "options": { "name": "Options", "type": "short_text", "value": null }, "salary": { "name": "Salary", "type": "short_text", "value": null } } } } } </code></pre></div> The Job Updated event is triggered any time one or more of the following fields are changed for a job: Internal Job Name, Department, Office, Level, Open Date, Status, Notes, Team and Responsibilities, and How To Sell This Job. Changes to custom fields on a job will also trigger this webhook. <table><thead> <tr> <th>Attribute</th> <th>Note</th> </tr> </thead><tbody> <tr> <td><code>hiring_team</code></td> <td>Field contains the Greenhouse users responsible for this job. Each field contains the user's Greenhouse user id and the user's external employee id from the customer's system. The employee id will be null if it has not been set in Greenhouse.</td> </tr> <tr> <td><code>openings</code></td> <td>Field contains all the openings in this job. The custom field element on each opening may be omitted if the organization does not have custom fields on openings enabled.</td> </tr> </tbody></table> <h2 id='job-approved'>Job Approved</h2><div class="highlight"><pre class="highlight json tab-json"><code>{ "action": "job_approved", "payload": { "approval_flow": { "approval_flow_type": "open_job" }, "job": { "id": 100445, "name": "Assistant Store Manager, NYC", "requisition_id": null, "notes": "Looking for the best!<\/p>", "confidential": false, "job_post_id": 88010, "status": "open", "created_by_id": 273555, "created_at": "2015-08-11T23:02:09Z", "opened_at": "2015-08-11T23:02:09Z", "closed_at": null, "departments": [ { "id": 74, "name": "Guideshops", "external_id": "ex-dept-1" } ], "offices": [ { "id": 104, "name": "New York", "location": "New York, NY", "external_id": "ex-office-1" } ], "hiring_team": { "hiring_managers": [ { "user_id": 1234, "employee_id": "abc-123" } ], "sourcers": [], "recruiters": [ { "user_id": 2345, "employee_id": null }, { "user_id": 3456, "employee_id": "abc-234" } ], "coordinators": [] }, "openings": [ { "id": 1234, "opening_id": "abc-1", "custom_fields": [] }, { "id": 1235, "opening_id": "abc-2", "custom_fields": [] } ], "custom_fields": { "bonus": { "name": "Bonus", "type": "short_text", "value": null }, "employment_type": { "name": "Employment Type", "type": "single_select", "value": null }, "options": { "name": "Options", "type": "short_text", "value": null }, "salary": { "name": "Salary", "type": "short_text", "value": null } } } } } </code></pre></div> The Job Approved event is triggered when the final approval is received in a Greenhouse job's approval flow. "Approvals to start recruiting" will be identified as "approval_flow_type": "open_job" while "Official job approval" will be identified as "approval_flow_type": "offer_job". <h2 id='job-post-created'>Job Post created</h2> This webhook fires when a job post or prospect post is created. This occurs when a new job post or prospect post is added from the job set up. If <code>job_id</code> is present in the payload, the payload represents a new job post. If <code>job_id</code> is not present, the payload represents a new prospect post. <div class="highlight"><pre class="highlight json tab-json"><code>{ "action": "job_post_created", "payload": { "id": 1815002, "title": "A Cool Job", "location": "New York, NY", "content": "Hey, this is a neat job. You should apply!", "internal_content": null, "updated_at": "2017-10-12T15:06:32.691Z", "job_id": 1842002, "external": true, "internal": false, "live": false, "questions": [ { "required": false, "private": false, "label": "LinkedIn Profile", "type": "input_text", "values": [] }, { "required": false, "private": false, "label": "Website", "type": "input_text", "values": [] }, { "required": false, "private": false, "label": "How did you hear about this job?", "type": "input_text", "values": [] } ] } } </code></pre></div><h2 id='job-post-updated'>Job Post updated</h2> This webhook fires when a job post or prospect post is updated via the "Edit Job Post" page. It also fires when the live status of the job changes from on to off or vice-versa. If <code>job_id</code> is present in the payload, the payload represents an updated job post. If <code>job_id</code> is not present, the payload represents an updated prospect post. <div class="highlight"><pre class="highlight json tab-json"><code>{ "action": "job_post_updated", "payload": { "id": 1813002, "title": "A Cool Job", "location": "At a Cool Place", "content": "Come work for us!", "internal_content": null, "updated_at": "2017-10-12T18:29:08.399Z", "job_id": 1842002, "external": true, "internal": false, "live": false, "questions": [ { "required": false, "private": false, "label": "LinkedIn Profile", "type": "input_text", "values": [] }, { "required": false, "private": false, "label": "Website", "type": "input_text", "values": [] }, { "required": false, "private": false, "label": "How did you hear about this job?", "type": "input_text", "values": [] } ] } } </code></pre></div><h2 id='job-post-deleted'>Job Post deleted</h2> This webhook fires when a job post or prospect post is deleted. This occurs when the delete link is clicked on a post. Only posts that are not live may be deleted. This will not fire if a job itself is deleted; a job being deleted implies all of its posts have been deleted with them. If <code>job_id</code> is present in the payload, the payload represents a deleted job post. If <code>job_id</code> is not present, the payload represents a deleted prospect post. <div class="highlight"><pre class="highlight json tab-json"><code>{ "action": "job_post_deleted", "payload": { "job_post": { "id": 258341, "job_id": 284999, "title": "Software Engineer", "location": "Dallas", "content": "A pretty interesting job post!", "updated_at": "2017-01-19T20:01:53.146Z", "internal_content": null, "questions": [ { "required": false, "private": false, "label": "LinkedIn Profile", "type": "input_text", "values": [] }, { "required": false, "private": false, "label": "Website", "type": "input_text", "values": [] }, { "required": false, "private": false, "label": "How did you hear about this job?", "type": "input_text", "values": [] }, { "required": true, "private": true, "label": "Are you a cool engineer?", "type": "multi_value_single_select", "values": [ "Yes", "No", "As a cucumber" ] } ], "external": true, "internal": false, "live": false } } } </code></pre></div><h2 id='job-stage-deleted'>Job Stage deleted</h2> This webhook only fires when interview stages on a job are removed. This occurs when the remove stage link is used in the Job Setup section of the application. This will not fire when a job is deleted. A job being deleted implies all of its stages have been deleted with them. <div class="highlight"><pre class="highlight json tab-json"><code>{ "action": "job_interview_stage_deleted", "payload": { "job_interview_stage": { "id": 430608, "job_id": 60453, "created_at": "2015-03-11T13:25:25.313Z", "updated_at": "2016-08-16T09:29:33.650Z", "name": "Phone Screen", "active": true } } } </code></pre></div><h1 id='organization-events'>Organization Events</h1><h2 id='department-deleted'>Department deleted</h2> This webhook fires when departments are deleted from the Greenhouse system from the Configure » Organization screen. This only happens when the "Remove" button is clicked after clicking the "X" next to an office name. <div class="highlight"><pre class="highlight json tab-json"><code>{ "action": "department_deleted", "payload": { "department": { "id": 106, "name": "Creative", "child_ids": [ 23328 ], "parent_id": 5, "external_id": "ex-office-1" } } } </code></pre></div><h3 id='noteworthy-response-attributes'>Noteworthy response attributes</h3> <table><thead> <tr> <th>Attribute</th> <th>Note</th> </tr> </thead><tbody> <tr> <td><code>id</code></td> <td>The Greenhouse id for the department</td> </tr> <tr> <td><code>name</code></td> <td>The name of the department deleted</td> </tr> <tr> <td><code>child_ids</code></td> <td>Any former child department ids (this includes all descendants); will be [] if empty</td> </tr> <tr> <td><code>parent_id</code></td> <td>The department's parent department id; will be null if empty</td> </tr> </tbody></table> <h2 id='office-deleted'>Office deleted</h2> This webhook fires when offices are deleted from the Greenhouse system from the Configure » Organization screen. This only happens when the "Remove" button is clicked after clicking the "X" next to an office name. <div class="highlight"><pre class="highlight json tab-json"><code>{ "action": "office_deleted", "payload": { "office": { "id": 16492, "name": "New York", "location": { "name": "New York, NY" }, "child_ids": [ 123, 456 ], "parent_id": 789, "external_id": "ex-dep-1" } } } </code></pre></div><h3 id='noteworthy-response-attributes-2'>Noteworthy response attributes</h3> <table><thead> <tr> <th>Attribute</th> <th>Note</th> </tr> </thead><tbody> <tr> <td><code>id</code></td> <td>The Greenhouse id for the office</td> </tr> <tr> <td><code>name</code></td> <td>The name of the office deleted</td> </tr> <tr> <td><code>location</code></td> <td>The location for the office</td> </tr> <tr> <td><code>child_ids</code></td> <td>Any former child office ids; will be [] if empty</td> </tr> <tr> <td><code>parent_id</code></td> <td>The office's parent office id; will be null if empty</td> </tr> </tbody></table> </div> <div class="dark-box"> <div class="lang-selector"> <a href="#" data-language-name="json">json</a> </div> </div> </div> </body> </html>