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
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.
POST to https://recruit.zoho.com/recruit/v2/{module_api_name} (e.g. Candidates, Job_Openings) with header Authorization: Zoho-oauthtoken {token}.
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.
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.
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.
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
Duplicate checking runs on every insert call based on the module's configured unique fields — an insert can silently fail per-record with a duplicate error even when the overall HTTP call succeeds.
Field length and data-type limits are enforced server-side (e.g. Single Line Text caps at 255 characters); exceeding them returns an INVALID_DATA error for that specific record, not the whole batch.
Insert Records only supports specific modules (Candidates, Job Openings, Interviews, Clients, Contacts, Departments, Tasks, Events, Vendors, and Custom Modules) — other modules require different endpoints.
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?