1. Greenhouse Support
  2. All Recruiting topics
  3. Integrations
  4. Optimization

Paraform integration

Paraform is a recruiting marketplace that connects companies with independent recruiters and recruiting agencies.

Paraform's integration with Greenhouse Recruiting lets your team send Paraform candidates to a linked Greenhouse job, keep application stages and hiring outcomes in sync, and review candidate details in either system.

In this article

Configure the Paraform integration

Before you begin

You need Company Editor access in Paraform and Site Admin access in Greenhouse Recruiting.

Connect Greenhouse

In Paraform, go to Settings > Integrations and select Greenhouse.

Review the required access. Choose whether Paraform may read candidate notes and submitted interview scorecards.

Select Continue to Greenhouse.

Choose the optional Greenhouse data that Paraform may read before authorization

Sign in to Greenhouse as a Site Admin.

Review the permissions. Select Authorize using a service account, then select Authorize.

Greenhouse authorization page for Paraform with Authorize using a service account selected

Return to Paraform. Wait for Greenhouse connected — access up to date.

Paraform checks Harvest V3 access and creates any missing webhook subscriptions. You do not need to create webhooks manually.

A connected account shows that OAuth and required Harvest V3 access are healthy

Data access and field mapping

Area Paraform reads from Greenhouse Paraform writes to Greenhouse
Jobs and users Job ID, name, status, job posts, hiring managers, user job permissions, and interview stages None
Candidates Name, personal email, phone, tags, attachments, applications, and optional public notes First and last name, primary personal email, optional mobile number, resume PDF, Paraform tag, and public activity note
Applications Job, source, current stage, rejection or hire state, and rejection details Linked job, starting or current stage, source, rejected, unrejected, and hired status
Interviews Scheduled interviews, interview kits, questions, answer options, default interviewers, and optional submitted scorecards and answers None
Integration Sources, candidate tags, rejection reasons, and webhook status Creates or updates Paraform-owned webhooks and rotates the signing secret

Paraform does not require Greenhouse custom fields. Paraform requests optional access to candidate notes and submitted interview scorecards only when your company enables it.

Webhook events

Paraform creates six webhook subscriptions:

  • Candidate has changed stage
  • Candidate has been hired
  • Candidate has been unhired
  • Candidate or prospect rejected
  • Candidate or prospect unrejected
  • Offer created
  • Open the Paraform role and select the matching Greenhouse job.
  • Map each Paraform interview stage to the matching Greenhouse stage.
  • Choose the Greenhouse stage that receives candidates from Upload to ATS.
  • If a Greenhouse stage is not used in Paraform, select Skip if not used.
  • Save the mapping.

Map Paraform interview stages to the linked Greenhouse job

Use the Paraform integration

Send a candidate to Greenhouse

  • Move the candidate to Upload to ATS in Paraform.
  • Paraform creates the candidate and application on the linked Greenhouse job at the mapped stage.
  • Paraform sends the candidate's contact details, resume, source, Paraform tag, and public activity note.
  • Open the candidate profile in Greenhouse to review the application and current stage.
  • Continue the hiring workflow in either system. Greenhouse webhooks send stage and outcome changes to Paraform. Paraform can move, reject, unreject, or hire the application in Greenhouse when you take the matching action in Paraform.

Greenhouse Recruiting candidate profile showing the application and current stage

Manage and troubleshoot the integration

Change optional data access

  • In Paraform, go to Settings > Integrations > Greenhouse.
  • Change candidate note or interview scorecard access.
  • Select Save & reauthorize, then complete Greenhouse authorization. Your current connection stays active until the new authorization succeeds.

Troubleshooting

  • Greenhouse is not connected: Ask a Greenhouse Site Admin to complete authorization.
  • Access is out of date: Select Save & reauthorize and complete authorization again.
  • A job or stage is missing: Confirm that the Greenhouse job is open and has an interview plan, then refresh the mapping.
  • A candidate did not sync: Confirm the role is linked to the correct Greenhouse job and that Upload to ATS has a mapped stage.

Additional resources

For help, email help@paraform.com.