Zoho Recruit icon

Zoho Recruit

Interact with Zoho Recruit API v2 and v2.1

Submissions API → Create Submission

AI-generated

Summary

Create a new submission record in Zoho Recruit's Submissions API by providing candidate, client, department, job opening, or application identifiers along with submission details such as the recipient, medium, and related content.

Inputs

  • Candidate Name — Candidate ID (Candidate_Name). Required unless Application Name is provided.
  • Client Name — Client ID (Client_Name). Required if Department Name is empty and Application Name is not provided.
  • Department Name — Department ID (Department_Name). Required if Client Name is empty and Application Name is not provided.
  • Job Opening Name — Job opening ID (Job_Opening_Name). Required unless Application Name is provided.
  • Application Name — Application ID (Application_Name). If set, Candidate Name and Job Opening Name become optional.
  • Submitted To (required) — Submitted_To value; a string ID for Corporate HR or an array of contact objects for a Staffing Agency.
  • Medium (required) — Medium through which submission is made; options are 'Email' or 'Share'.
  • Mail Content — JSON object for $mail_content, used only if Medium is 'Email'.
  • Description — Description text used only if Medium is 'Share'.

Output shape

a single record representing the created submission response

The output contains the API response data for the created submission. Input validation errors throw exceptions with descriptive messages for missing required fields depending on provided parameters.

Examples

Example 1: Creating a submission with candidate and job opening names, specifying submitted to and email medium with mail content

Provide Candidate Name, Job Opening Name, Submitted To JSON, Medium set to 'Email', and Mail Content JSON.

Links

Discussion