Skip to main content

​
ATS Integrations

Connect your Applicant Tracking System (Greenhouse or Ashby) to Gradient. Two independent capabilities:
  • Job import — Gradient holds your ATS API key and reads your jobs and candidates, so you can seed roles from real job descriptions and pull candidates in.
  • Assessment partner — you paste a Gradient-minted partner key into your ATS, and the ATS starts Gradient assessments and receives the scores back.
These endpoints are admin-only and used by the Settings → Integrations UI. The feature is gated per organization; contact Gradient to enable it.

​
Connection status

Returns the connection + partner-key status for every supported provider. Never returns any secret — only the last four characters of a connected key and the non-secret partner-key prefix.

​
Connect a provider

:provider is greenhouse, ashby, or workday. The credential is validated with a live call before it is stored (encrypted at rest).
​
string
required
The provider credential. Greenhouse: a Harvest API key. Ashby: an API key with job and application read access. Workday: a JSON string { tenant, host, clientId, clientSecret, refreshToken } for an OAuth API client with Recruiting read scope.

​
Disconnect a provider

Removes the stored key for that provider.

​
Health check

Probes the provider live with the stored key and returns { ok: boolean }, updating the connection status.

​
Partner key — info

Returns the non-secret prefix of the minted partner key, or null if none has been minted for this provider. :provider must be greenhouse or ashby — Workday has no assessment-partner framework.

​
Partner key — mint or rotate

Mints (or rotates) the assessment-partner key you paste into your ATS (greenhouse or ashby only). Returns the full key once in the response; any previously minted key stops working immediately.

​
Search ATS jobs

Search open jobs on the connected provider, for the role-import picker.
​
string
required
greenhouse or ashby.
​
string
Case-insensitive title filter. Omit to list all open jobs.
​
string
When present, returns that single job’s full detail (including the job description body) instead of a search list.
​
string
required
greenhouse or ashby.
​
string
required
The ATS job id to link this role to.
​
string
A display name for the linked job. Defaults to the job id.
Clears the role’s ATS job link.

​
List candidates on a role’s linked job

Returns the candidates (applications) on the ATS job this role is linked to, each flagged with whether it is already imported into Gradient.

​
Pull candidates into Gradient

Imports the selected applications as Gradient candidates, deduped on their ATS application id.
​
string[]
required
The ATS application ids to import.