The Chaincademy integration

The Chaincademy is an AI-assisted recruiting solution for Greenhouse. When a candidate submits a job application, The Chaincademy uses the connected integration to analyze the candidate's CV, LinkedIn profile, GitHub public repository, and CV-based hard and soft skills.

The analysis results are stored by The Chaincademy, written back to the candidate's Greenhouse Activity Feed as notes, and displayed in The Chaincademy Chrome extension.

Configure the integration

Chaincademy provides a secure, customer-specific connect URL that starts the authorization flow. The invite token is generated by The Chaincademy and should only be shared with the Greenhouse administrator responsible for approving the integration. The secure connect URL looks like this:

https://workspace.devetta.co/greenhouse/oauth/redirect?invite={invite_token}

Authorize connection screen

Authorize the integration with a dedicated Integration System User (ISU) or service account when available. This helps keep audit history clear in Greenhouse.

After authorization is approved, Greenhouse redirects back to The Chaincademy and the tenant connection is stored. The Chaincademy can now refresh tokens and configure the required Greenhouse setup automatically.

You can verify this connection in Greenhouse under Configure > Dev Center > Connected Integrations.

Automatic webhooks and custom fields setup

After the connection is approved, The Chaincademy automatically creates the required Greenhouse webhooks and application custom fields through the Greenhouse Partner APIs.

The webhooks keep candidate and application data synchronized with The Chaincademy, including new applications, updates, stage changes, deleted applications, deleted candidates, and anonymized candidates.

The Chaincademy also creates two application custom fields used to capture the candidate's LinkedIn profile URL and GitHub public repository URL.

Application custom fields

After The Chaincademy creates the application custom fields automatically, add them to each job's custom application questions so candidates can provide their LinkedIn profile and GitHub public repository URLs when applying.

In Greenhouse, go to Jobs and select the job where you want to enable The Chaincademy analysis.

Click Job Setup.

Click Job Posts.

Click the pencil icon to edit the job post.

Scroll down to Custom application questions.

Click Add custom question. In the answer type dropdown, select "Link answers to a custom field on candidate's profile". Choose the LinkedIn Profile URL custom field and mark "Is this question required?" if your team wants LinkedIn analysis to run for every application. Repeat the same flow to add the GitHub repo URL custom field.

The question labels can be written in the language used by your hiring team, but the linked custom fields should be the fields created by The Chaincademy: linkedin_profile_url and git_hub_repo_url.

When a candidate submits a new job application, The Chaincademy automatically runs AI analyses for the candidate's CV, LinkedIn profile, GitHub repository, and CV-based skills. The results are available in the Greenhouse Activity Feed and in The Chaincademy Chrome extension.

Greenhouse application form

Configure Chrome extension

To set up the Chrome extension, open The Chaincademy extension settings, paste The Chaincademy Chrome Extension API key shown after authorization, then click Save and Test.

Use the integration

After the integration is successfully set up, every time a new candidate applies to one of your jobs, The Chaincademy automatically runs AI analyses on the candidate's CV, LinkedIn profile, GitHub repository, and CV-based hard and soft skills.

The analysis results are written back to the candidate's Greenhouse Activity Feed and are also available in The Chaincademy Chrome extension.

Candidate Activity Feed showing The Chaincademy notes

The Chaincademy Chrome extension showing candidate overview, contact details, links, employment history, and education.

The Chaincademy Chrome extension showing AI analysis results for CV, skills, LinkedIn, and GitHub.

Data retention & privacy

CV files are downloaded temporarily for analysis and deleted immediately after processing completes (success or failure). The Chaincademy stores only the derived analysis outputs (notes, scores, and structured JSON) required to display results in Greenhouse and The Chaincademy Chrome extension. If you require a different retention policy, contact Chaincademy support before enabling the integration. Chaincademy stores the analysis results internally so they can be surfaced inside The Chaincademy browser extension and related workspace tools.

Troubleshooting

Webhook returns 401

This usually means the webhook signature could not be validated. Because The Chaincademy creates webhooks automatically, customers should verify that the Greenhouse OAuth connection is active and contact Chaincademy support if the issue persists.

Check:

• the Greenhouse OAuth connection is active
• the integration webhooks were created automatically
• the candidate submitted an application after the integration was connected
• the candidate application includes a resume/CV attachment
• the Chrome extension API key was copied correctly

No analysis results appear

Check:

• the Greenhouse OAuth connection is active
• the integration webhooks were created automatically
• the candidate submitted an application after the integration was connected
• the candidate application includes a resume/CV attachment
• the LinkedIn and GitHub application questions were added to the job, if those analyses are expected
• the Chrome extension API key was copied correctly

GitHub or LinkedIn analysis is missing

Check:

• the LinkedIn and GitHub application custom fields were added to the job's application questions
• the field keys are linkedin_profile_url and git_hub_repo_url
• the candidate submitted valid LinkedIn and GitHub URLs

Notes or attachments do not appear in Greenhouse

Check:

• the OAuth connection is active
• the integration was authorized successfully
• the Greenhouse permission set includes the required read and write permissions
• the integration was authorized with an account allowed to perform those actions

Additional resources

For support or troubleshooting assistance, contact The Chaincademy at contact@thechaincademy.com.