← all tools
Recruiting CRM

Vincere

Everything you sourced lands in Vincere, on the right record.

Vincere is a recruiting CRM, and one of the 53 tools hyreflow connects to Claude, ChatGPT and other AI assistants. Through hyreflow, an AI agent can run 9 actions: 6 that look something up and 3 that create or change records. Vincere costs no hyreflow credits, and runs on your own Vincere account.

Cost per callfree
Your own keyoptional
CategoryRecruiting CRM

Your agent searches Vincere before it creates anything, so you do not end up with duplicates, then writes the genuinely new ones in. It reads your jobs, companies and contacts as well.

Vincere is the destination. Sourcing and enrichment feed it.

What can you ask Claude or ChatGPT to do with Vincere?

With hyreflow connected, you ask for the outcome in plain language and the assistant runs Vincere for you. For example:

  • “Push this shortlist in, skipping anyone already on the database”
  • “What jobs am I working? Build a longlist for this one using Apollo”
  • “Update this record with the mobile LeadMagic found”
  • “Write the Fathom debrief onto the candidate”

Which tools work well with Vincere?

In a hyreflow run, Vincere is most often paired with Apollo, LeadMagic, Fathom and SourceWhale.

  • Apollo

    source against the roles already live in Vincere

  • LeadMagic

    fill the contact gaps on records you already hold

  • Fathom

    interview debriefs onto the candidate record

  • SourceWhale

    outreach shaped the way the desk is measured

Which Vincere actions can an AI agent run through hyreflow?

Through hyreflow, an AI agent can run 9 Vincere actions: 6 that look something up and 3 that create or change records. Vincere costs no hyreflow credits, and runs on your own Vincere account.

Vincere actionWhat it doesCost through hyreflow
Search candidatesLooks something upno hyreflow credits
Search companiesLooks something upno hyreflow credits
Search contactsLooks something upno hyreflow credits
Search jobsLooks something upno hyreflow credits
Create candidateCreates or changes a recordno hyreflow credits
Create candidates batchCreates or changes a recordno hyreflow credits
Update candidateCreates or changes a recordno hyreflow credits
Get candidateLooks something upno hyreflow credits
Get jobLooks something upno hyreflow credits

One credit is priced on the pricing page. The full price list for every tool is in the pricing tables.

How does an AI agent know how to use Vincere?

hyreflow ships a written playbook for Vincere, and the agent loads it before the first call. Auth, rate limits, what each call costs, which actions need your approval, and the mistakes worth avoiding. It is the difference between an agent that knows the tool and one that guesses at it.

Read the Vincere docs →
Show the raw playbookwritten for the agent

HOW in lib/vincere.py.

Auth & config (two headers)

  • Base URL: https://{tenant}.vincere.io/api/v2 — the tenant is the workspace's own Vincere subdomain.
  • Connect: connect Vincere from the dashboard's Integrations page with the tenant, Client ID and API key Vincere issued for the account, then sign in to Vincere. No client secret.
  • Auth: BOTH x-api-key AND id-token (1 h TTL). The id-token refreshes automatically once connected — no manual refresh needed.

Operations (paths CONFIRMED 2026-06-01; full spec signup-gated)

Candidates: search_candidates, get_candidate, create_candidate, update_candidate. Reads: search_jobs, get_job, search_companies, search_contacts. Index: reference/docs/vincere/raw/endpoints.md.

  • Jobs are job (NOT position) in v2 — confirmed. Search paths carry a trailing slash (/candidate/search/).
  • Search quirk: fl/sort are matrix params on the path (/candidate/search/fl=id,name;sort=created_date asc?q=...), q is a query param. The client passes fl/q as query params; if a search 400s, build the matrix path via request().

Guardrail

Production ATS writes — pilot one, confirm, then bulk. Watch for id_token expiry (refresh + retry).

Handoff

ATS write target: enriched candidates → create_candidate.

Callable surface — lib/vincere.py

Import: from lib.vincere import Vincere → instantiate Vincere() (reads key from env). Generic passthrough: request(method, path, *, params, json).

  • batch(method: str, calls: list, *, stop_on_error: bool = False) -> dict — Batched get/search/update/create: run one method over many inputs, rate-limited. Each call is a value -> method(value), or {"args": [...], "kwargs": {...}} for multi-arg methods like update_candidate(id, payload). Destructive methods (delete) are refused. See lib/_base.run_ops.
  • create_candidate(payload: dict) -> Any — POST /candidate — create a candidate.
  • create_candidates_batch(payloads: list[dict], *, stop_on_error: bool = False) -> dict — POST /candidate for many records, respecting VINCERE_RATE_LIMIT_RPM.
  • get_candidate(candidate_id: str, *, fields: str | None = None) -> Any
  • get_job(job_id: str, *, fields: str | None = None) -> Any
  • search_candidates(q: str, *, fl: str | None = None, sort: str | None = None, **params) -> Any — GET /candidate/search/ — q uses Vincere's field:terms# syntax; fl=returned fields, sort=e.g. "created_date desc".
  • search_companies(q: str, *, fl: str | None = None, sort: str | None = None, **params) -> Any — GET /company/search/.
  • search_contacts(q: str, *, fl: str | None = None, sort: str | None = None, **params) -> Any — GET /contact/search/.
  • search_jobs(q: str, *, fl: str | None = None, sort: str | None = None, **params) -> Any — GET /job/search/ — jobs are job in Vincere v2 (CONFIRMED — not position).
  • set_id_token(id_token: str) — Swap in a freshly-refreshed id_token (they expire after 1 h).
  • update_candidate(candidate_id: str, payload: dict) -> Any

Questions about Vincere and hyreflow

Can I use Vincere inside Claude or ChatGPT?

Yes. hyreflow is a connector for Claude, ChatGPT and other AI assistants. Once hyreflow is connected, you ask for the outcome in plain language and the assistant calls Vincere for you. hyreflow exposes 9 Vincere actions this way.

Do I need my own Vincere account to use it with hyreflow?

Yes. Vincere runs on your own Vincere account. You connect it to hyreflow once, hyreflow charges no credits for the calls, and Vincere bills you as before.

What does Vincere cost through hyreflow?

Vincere costs no hyreflow credits, and runs on your own Vincere account.

How do I connect Vincere to an AI agent over MCP?

Add the hyreflow MCP server to your assistant and sign in. hyreflow calls the Vincere API directly and exposes its actions as tools the assistant can run, so there is no separate Vincere server to install.

Connect hyreflow to your assistant →

Put Vincere to work from one prompt

Connect hyreflow to Claude or ChatGPT and ask for the outcome. It reads the playbook above before it makes a single call.