Zoho Recruit

Use Zoho Recruit as a read source ahead of sourcing: check its Candidates for a match before paying for external people data, pull its Clients as a do-not-contact list for outbound, and turn a Job Opening's description into search filters. It has no write methods here — enriched candidates still land in whichever ATS/CRM the agency writes to.

Capabilities

Guidance

• Search takes exactly one of criteria, email, phone or word. criteria looks like ((Field:operator:value)and(Field:operator:value)), up to 10 conditions — escape a comma or parenthesis inside a value with a backslash.
• A search with no match comes back as an empty result, not an error.
• per_page caps at 200; page until the response says there are no more records.
• Field names vary per account — the job-description field in particular isn't standardized. Call get_fields(module="Job_Openings") (or Candidates/Clients) rather than guessing a field name.
• Search the ATS before running people_search on external providers: search_candidates(email=…) for an exact dedup check, or a criteria/word search on the role's must-haves, then only source externally for the gap.
• Building an outbound exclusion list: page list_clients(per_page=200) to the end, collect Client_Name + website domains, and drop those companies from your target list before a staffing/BD campaign.

hyreflow tools execute zoho_recruit search_candidates \
  --payload '{"email":"[email protected]"}'

Connect

Zoho Recruit connects self-serve via OAuth from Integrations → Zoho Recruit. The card offers two choices:

• Hyreflow's app (the default, where enabled) — click Connect and approve on Zoho's consent screen. Nothing to register, nothing to paste.
• Your own Zoho app — create a Server-based Application at api-console.zoho.com, set its Authorized Redirect URI to the one shown on the card (https://recruit.hyreflow.ai/api/v2/integrations/zoho_recruit/oauth/callback), paste its Client ID and Client Secret, pick the data center your account lives in (United States, Europe, India, Australia, Japan, Canada, Saudi Arabia or China), then click Connect and approve.

Either way Hyreflow stores the connection and refreshes the access token automatically — no refresh token is ever pasted, and picking your own app is what makes the engine use it; you can switch back to Hyreflow's at any time, though either switch means re-authorizing.