Zoho Recruit API v2: insert (create) Candidate and Job Opening records

domain: zoho.com · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Complete Zoho OAuth2 and obtain an access token with a scope covering the target module, e.g. ZohoRECRUIT.modules.candidate.CREATE or ZohoRECRUIT.modules.ALL.
  2. POST to https://recruit.zoho.com/recruit/v2/{module_api_name} (e.g. Candidates, Job_Openings) with header Authorization: Zoho-oauthtoken {token}.
  3. Wrap the record(s) to insert in a top-level 'data' array, using only Field API names (not display labels) as keys, and send up to 100 records per call.
  4. For lookup-type fields, pass a JSON object with the related record's id and name (e.g. Department_Name: {id, name}); for multi-select lookups, pass a JSON array of such objects.
  5. Optionally set $state to 'draft' to save the record as a draft instead of a normal record, and set 'trigger' to [] if you want to suppress associated workflows/approvals/blueprints.
  6. Check each entry in the response 'data' array for code SUCCESS/status success versus per-record error codes like MANDATORY_NOT_FOUND or INVALID_DATA.

Known gotchas

Related routes

Create a candidate record in Zoho Recruit using the API v2 Candidates module
zoho.com · 6 steps · unrated
List and cross-link Candidates and Job Openings records via Zoho Recruit's REST API v2
recruit.zoho.com · 6 steps · unrated
Search and create Person/Candidate and Job records via Loxo's Open API
loxo.co · 6 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans