Actions22
- Record APIs Actions
- Submissions API Actions
- Assessments API Actions
- Reviews APIs Actions
- Notes APIs Actions
- Files & Attachments APIs Actions
- Bulk API Actions
Submissions API → Create Submission
AI-generatedSummary
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.
