Integration guide

Connect HiringHero to Ashby

HiringHero is available in the Ashby Marketplace. The integration uses an Ashby API key to create clearly identified candidate and application records from an explicit, authorized workflow. Credentials remain server-side and customer profile or resume data is never used by the sandbox demonstration.

Open HiringHero in Ashby Marketplace

Jobs: Read

Lists available Ashby jobs so an authorized HiringHero operator can select a destination.

Candidates: Read

Verifies the candidate and linked application created by the integration.

Candidates: Write

Creates a candidate, application, and integration note, and supports explicit anonymization.

Setup

1. Enable HiringHero. Open the official HiringHero tile in the Ashby Marketplace and enable the integration for your organization.
2. Generate an Ashby API key. Create the key from the HiringHero tile and grant only Jobs Read plus Candidates Read and Write.
3. Store the key securely. Add it only to HiringHero's server-side credential configuration. Never place the key in a browser, support ticket, source file, or public environment variable.
4. Run a bounded verification. An authorized HiringHero operator selects an Ashby job and explicitly confirms creation of one candidate and linked application.
5. Review in Ashby. Confirm the candidate, application, stage, and HiringHero integration note. Use the explicit anonymization control when a demonstration record is no longer needed.

Endpoints and data flow

job.list reads the selectable job list.

candidate.create creates the authorized candidate record.

application.create links that candidate to the selected job.

candidate.createNote records the integration source and safety context.

application.info verifies the completed application.

candidate.anonymize performs explicit demonstration cleanup.

The sandbox demonstration transmits a synthetic name, synthetic example.com email address, selected Ashby job ID, candidate ID, application ID, and a non-private integration note. It does not transmit HiringHero customer profiles, resumes, passwords, API keys, billing data, or hiring decisions.

Limits and safe operation

HiringHero does not make hiring decisions or submit employer applications on a user's behalf.
Every write requires an authenticated, allowlisted operator and an explicit confirmation.
The integration does not retry failed writes automatically. Partial candidate creation is anonymized when application creation fails.
Provider errors are bounded and credentials are never returned to the browser or written to runtime logs.
To disconnect, deactivate the HiringHero tile and revoke its Ashby API key.

Support

Contact support@hiringhero.ai for setup or security help. Do not email API keys, passwords, authentication codes, or confidential candidate data.