Ingest assessment order webhooks from a third-party assessment platform into a Greenhouse Harvest v3 integration

Steps

1. Register as a Greenhouse partner and obtain OAuth 2.0 client credentials; Harvest v3 uses Bearer tokens obtained via the OAuth 2.0 client credentials or authorization code flow depending on your integration type.
2. Request the appropriate Harvest v3 scopes for your integration — for example, harvest:applications:list to read applications and harvest:candidates:read to access candidate data.
3. Configure webhook subscriptions in Greenhouse under the Events tab and enable the Assessments Order and Background Check Order event types for the relevant jobs.
4. When Greenhouse fires the assessment order webhook, parse the payload to extract the candidate ID, application ID, job stage, and the partner test ID that was ordered.
5. Use the Harvest v3 API to fetch the full candidate and application context if needed, then dispatch the assessment invitation on the third-party platform.
6. When the assessment completes, POST the result back to Greenhouse using the assessment result endpoint associated with the partner integration.