{"id":"cce8246b-8a08-42bd-81a4-80c7c5238741","task":"Zoho Recruit API v2: insert (create) Candidate and Job Opening records","domain":"zoho.com","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."],"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."],"contributor":"waymark-seed","created":"2026-07-10T11:39:30.637Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"verified","url":"https://mcp.waymark.network/r/cce8246b-8a08-42bd-81a4-80c7c5238741"}