Try Free
Background ScreeningATS IntegrationHiring Operations

Vetty + Greenhouse Integration: Centralize Background Screening in Your ATS

Titus Juenemann August 8, 2024

TL;DR

The Vetty + Greenhouse integration centralizes background screening inside your ATS: orders are placed automatically, candidate data syncs via API, Vetty’s Verified Profile simplifies candidate interactions, and compliance rules reduce legal exposure. Ideal for high-volume hiring, regulated industries, and distributed teams, the integration delivers measurable reductions in admin time, fewer data errors, and clearer audit trails. Implement via API keys and webhooks, pilot with a subset of roles, map fields deliberately, and track KPIs like time-to-results and candidate completion rates to measure ROI. In short, the integration reduces friction and risks associated with screening while improving visibility and candidate experience.

The Vetty integration for Greenhouse connects background screening directly to your ATS workflow so hiring teams can order, monitor, and act on checks without leaving Greenhouse. This guide explains what the integration does, who benefits most, and the measurable operational improvements organizations typically see. You’ll get practical setup and configuration notes, recommended workflows, troubleshooting checks, and the KPIs to track after deployment. The focus is on objective, actionable guidance for talent acquisition, HR ops, and hiring managers evaluating or implementing Vetty within Greenhouse.

What the Vetty + Greenhouse integration does

  • Order background checks from the ATS Create Vetty screening requests directly from a Greenhouse candidate profile or stage action, eliminating double entry and manual file uploads.
  • Sync candidate data automatically Personal details, role, and contact information flow from Greenhouse to Vetty via secure API to reduce input errors and speed order placement.
  • Invite candidates to Vetty Verified Profile Vetty sends candidates a self-service verification link to upload documents and complete consent forms, keeping the process candidate-centric and transparent.
  • Status updates and results pushed back Real-time status updates and completed reports are mapped into Greenhouse so recruiters see progress and can gate hiring decisions on completed checks.
  • Compliance engine and alerts Vetty’s built-in rules flag jurisdictional restrictions and generate compliant actions or red flags that are visible to hiring teams in Greenhouse.
  • Document storage and audit trail Background reports, candidate consent records, and communications are retained with an audit trail for compliance and future review.

Implementation is a combination of configuration in Greenhouse and Vetty: exchange API keys, configure webhook endpoints, map candidate fields and screening packages, and choose which Greenhouse stage or custom action should trigger an order. The integration supports both automatic and manual ordering, letting teams start with a controlled pilot and expand automation as confidence increases. On the technical side, expect to set up an API credential in Vetty, create a Harvest API key in Greenhouse with appropriate permissions, configure webhook endpoints to receive status callbacks, and test end-to-end ordering using a sandbox candidate before going live.

ZYTHR for Greenhouse – Featured Section
ZYTHR - Your Screening Assistant

AI resume screener for Greenhouse

ZYTHR scores every applicant automatically and surfaces the strongest candidates based on your criteria.

  • Automatically screens every inbound applicant.
  • See clear scores and reasons for each candidate.
  • Supports recruiter judgment instead of replacing it.
  • Creates a shortlist so teams spend time where it matters.
ZYTHR - AI resume screener for Greenhouse ATS
Name Score Stage
Oliver Elderberry
9
Recruiter Screen
Isabella Honeydew
8
Recruiter Screen
Cher Cherry
7
Recruiter Screen
Sophia Date
4
Not a fit
Emma Banana
3
Not a fit
Liam Plum
2
Not a fit

Manual background screening vs Vetty integrated with Greenhouse

Manual process Vetty + Greenhouse
Order placed via email or separate portal; recruiter retypes candidate data Order placed inside Greenhouse; candidate data pushed automatically
High risk of data entry error and duplicate work Reduced errors due to API-driven field mapping and validation
Limited visibility for hiring managers; status tracked in spreadsheets Real-time status in Greenhouse with automated notifications
Candidate experience: opaque, multiple logins Candidate experience: single Vetty Verified Profile with clear status and uploads
Compliance review is manual and inconsistent Automated compliance rules and audit trails aligned to state/national laws

Who needs the Vetty + Greenhouse integration

  • High-volume hiring teams Organizations that process dozens to thousands of checks monthly will reduce manual effort and scale without adding headcount.
  • Regulated industries Healthcare, finance, transportation, and education employers that must adhere to state or federal screening requirements benefit from Vetty’s compliance rules.
  • Distributed and remote hiring Companies hiring remote employees across jurisdictions gain consistent, legally defensible screening workflows and centralized reporting.
  • Teams focused on candidate experience Recruiters who prioritize transparency and faster candidate actions will use Vetty’s Verified Profile to reduce candidate confusion and drop-off.
  • HR teams integrating onboarding systems When background checks need to feed HRIS or onboarding platforms, integration reduces duplication and accelerates new-hire setup.

Key benefits are operational and measurable: average order time drops from minutes of manual entry to seconds, error rates fall because of structured field mapping, and visibility increases—reducing time-to-offer or time-to-start. Teams commonly report a 20–50% reduction in administrative time for screening workflows after full adoption. Beyond time savings, improved compliance handling reduces legal exposure by enforcing jurisdictional rules, and candidate-centric workflows reduce withdrawal rates caused by confusing or opaque screening processes.

Common implementation and operational questions

Q: How long does setup typically take?

A: A basic setup with API keys, field mapping, and webhook configuration can be done in a few days; a full pilot including package customization and workflow testing often takes 2–4 weeks depending on internal approvals.

Q: What candidate checks are supported?

A: Vetty supports criminal searches, SSN traces, motor vehicle records, drug screens, education and employment verifications, and international checks—availability varies by jurisdiction and package.

Q: How is candidate consent handled?

A: Consent is captured within the Vetty Verified Profile; Vetty logs consent timestamps and stores records for audit and compliance purposes.

Q: How secure is data transmission?

A: Data flows over encrypted APIs and Vetty maintains audit logs; teams should confirm Vetty’s compliance certifications (e.g., SOC 2) and review data retention policies.

Best practices for configuration and workflows

  • Map fields deliberately Only map the fields you trust from Greenhouse and validate formats to avoid failed orders; use custom fields for screening-specific data like hire type or client codes.
  • Place screening trigger at the right stage Trigger checks at a consistent stage (e.g., Offer Accepted or Background Check stage) to avoid premature orders or candidate confusion.
  • Start with a pilot Run a controlled pilot with a subset of users or roles to validate packages, turnaround times, and candidate messaging.
  • Use conditional packages Configure package rules so different roles or jurisdictions trigger appropriate checks automatically to stay compliant and reduce manual selection errors.
  • Train recruiters and hiring managers Short, role-specific training reduces support tickets—cover how to trigger orders, read status indicators, and interpret Vetty’s compliance flags.

Candidate experience is a competitive differentiator. The Vetty Verified Profile gives applicants a single place to complete consent, upload documents, and track progress, reducing follow-up calls and email back-and-forth. Color-coded status indicators and clear action items lower candidate confusion and speed response times, which in turn reduces fall-through between offer and start.

Supported background check types and common use cases

Check Type Typical Use Case
Criminal records Required for safety-sensitive positions and many regulated roles
Motor Vehicle Record (MVR) Positions that operate company vehicles or require good driving history
Drug and substance screening Safety-critical roles or roles with regulatory drug-screening requirements
Employment and education verification Senior hires, roles with credential requirements, and audit-ready checks
International background checks Global hires or candidates with overseas work/education history
SSN trace and identity verification Confirm identity and uncover jurisdictions for criminal searches

Key KPIs to track after deployment

  • Time from order to results Measures operational speed and identifies bottlenecks by package or jurisdiction.
  • Percent of orders placed automatically Reflects adoption of the integration and reduced manual work.
  • Candidate completion rate Tracks how many invited candidates complete Vetty Profile steps without manual follow-up.
  • Adverse action cycle time Time to resolve or communicate issues when a report triggers a potential hire decision—important for legal defensibility.
  • Screening cost per hire Operational cost including vendor fees and internal admin time; helps calculate ROI.

Security, compliance, and data privacy are core to any background screening integration. Confirm encryption in transit and at rest, data retention and purge policies, consent capture and storage, and vendor certifications such as SOC 2. Since screening touches state and federal rules, review how Vetty’s compliance engine handles jurisdictional nuances and whether it provides audit logs and exportable records for legal review.

Troubleshooting checklist for common issues

Q: Orders aren’t appearing in Vetty after creating them in Greenhouse

A: Verify API keys and user permissions, check webhook delivery logs, confirm field mappings, and test with a sandbox candidate to see the error messages returned by Vetty.

Q: Candidate didn’t receive the Vetty invite

A: Confirm the candidate email is correctly formatted in Greenhouse, check spam filters, and verify that Vetty’s invite template and sender address are configured.

Q: Status updates aren’t syncing back

A: Review webhook endpoint health, ensure Greenhouse webhook listeners are active, and check Vetty’s callback logs for authorization or payload errors.

Q: Incorrect package selected

A: Audit conditional package rules, review automations or workflow macros in Greenhouse, and restrict who can manually override packages to prevent mistakes.

Selecting a background screening vendor and integrating it with your ATS is both a technical and operational exercise. Prioritize vendors with robust API documentation, responsive in-country support, clear SLAs, and the ability to pilot. Measure results against the KPIs above and iterate on mappings, messaging, and triggers to fully realize efficiency and candidate experience gains.

Speed Up Hiring Without Sacrificing Accuracy — Try ZYTHR

While Vetty streamlines background screening within Greenhouse, ZYTHR brings the same efficiency to resume screening. Use ZYTHR to automatically shortlist applicants, reduce manual CV review time, and surface the most relevant candidates so your team focuses on interviews and decisions—saving time and improving resume review accuracy.