Spott
Recruiting CRM/ATS — candidates, clients, client contacts, jobs, applications, notes, placements, tasks, and opportunities.
Ask for the outcome and your agent composes the run itself. Or start from a skill, a whole pipeline it already knows end to end.
browse all skills →What your agent reads before it touches Spott
Every tool ships with a written playbook, 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 Spott docs →Show the raw playbookwritten for the agent
Use Spott to load enriched leads and candidates into the ATS and to read/write jobs, clients, contacts, applications, notes, placements, tasks, and opportunities. It is a sink for an enriched CSV produced by the sourcing/enrichment layer, alongside the other CRM/ATS integrations.
Capabilities
| Tool | Does | Cost |
|---|---|---|
search_candidates |
Query candidates | Free |
create_candidate |
Create a candidate (req. firstName, lastName) |
Free |
search_clients |
Query clients (companies-as-accounts) | Free |
create_client |
Create a client (req. name, description, size, specialties) |
Free |
create_client_contact |
Create a client contact under a client (req. firstName, lastName) |
Free |
search_jobs |
Query jobs | Free |
create_job |
Create a job (req. stageId + company/role fields) |
Free |
create_application |
Create an application (req. vacancyId, candidateId, stageId, statusId) |
Free |
move_application |
Move an application to another stage | Free |
get_vacancy_stages |
Pipeline stage IDs for jobs | Free |
get_opportunity_stages |
Pipeline stage IDs for opportunities | Free |
create_opportunity |
Create an opportunity (req. stageId) |
Free |
search_people |
Tenant-wide people search | Free |
Guidance
- The module name is
spott; run it viahyreflow tools execute spott <method>. - Writes are real production changes — dry-run one record, show the payload + response, get explicit go-ahead before bulk.
- Jobs, applications, and opportunities all need a pipeline
stageId(applications also needstatusId) — resolve it first withget_vacancy_stages,get_client_stages, orget_opportunity_stages. - Record deletion is not exposed for any resource.
- Handoff: enrichment produces a CSV → inspect it (rows, columns, samples) → map columns → load via the
create_*methods.
hyreflow tools execute spott create_candidate \
--payload '{"firstName":"Ada","lastName":"Lovelace","email":"[email protected]"}'
Rate limits & bulk writes
Spott publishes a rate limit of 600 requests/minute per API key. Use the batch helpers for large pushes — they loop single calls and pace requests automatically:
hyreflow tools execute spott create_candidates_batch \
--payload '{"payloads":[{"firstName":"Ada","lastName":"Lovelace"},{"firstName":"Grace","lastName":"Hopper"}]}'