Vincere
Recruiting ATS/CRM reads and writes via the v2 API. Key gotcha: needs two headers and the id_token expires in ~30 minutes.
Use Vincere as the ATS/CRM write target at the end of a recruiting pipeline — push enriched candidates in, and read jobs, companies, and contacts back out.
Free on Hyreflow (0 credits) — runs on your own Vincere credentials, not self-serve yet; contact Hyreflow to get it enabled. You pay only for the upstream sourcing/enrichment.
Capabilities
| Tool | Does | Cost |
|---|---|---|
vincere_search_candidates | Search candidates (q Lucene-style, fl=fields) | Free |
vincere_get_candidate | Fetch a candidate by id | Free |
vincere_create_candidate | Create a candidate | Free |
vincere_update_candidate | Update a candidate | Free |
vincere_search_jobs | Search jobs (job, not position in v2) | Free |
vincere_search_companies | Search companies | Free |
vincere_search_contacts | Search contacts | Free |
Guidance
- Two-header auth: every call needs BOTH
x-api-key(company key) ANDid-token(OAuth). Env:VINCERE_TENANT,VINCERE_API_KEY,VINCERE_ID_TOKEN. - The id_token expires in ~30 min — mint/refresh it via the Vincere OAuth (Auth0) flow externally, then
set_id_token(...). On a write failure, refresh and retry. - Jobs are
job, notpositionin v2 — confirmed. Search paths carry a trailing slash (/candidate/search/). - Search quirk:
fl/sortare matrix params on the path,qis a query param. If a search returns 400, build the matrix path via the genericrequest()passthrough. - Production ATS writes — pilot one
create_candidate, confirm it, then bulk.
hyreflow tools execute vincere vincere_create_candidate \
--payload '{"payload":{"first_name":"Ada","last_name":"Lovelace","email":"[email protected]"}}'Enriched candidates land here at the end of the pipeline: source → enrich → verify → create_candidate.
Rate limits & bulk writes
Vincere does not publish a fixed RPM, so the adapter defaults to a conservative 60 requests / minute.
Use create_candidates_batch for large pushes.
See Bulk pushes to ATS / recruiting CRM.
TheirStack
Tech-stack-driven company discovery and tech-filtered job search. Key gotcha: keyword slugs are kebab-case (validate first), and there is no email-provider filter.
Wiza
LinkedIn → email/phone enrichment that accepts Sales Navigator and Recruiter URLs. Key gotcha: reveals are async (start + poll); a phone reveal costs more than an email-only one.