Apply for a Vacancy

Submit a candidate application for a specific vacancy.

Request

POST /v1/vacancies/{refNo}/apply
Content-Type: multipart/form-data
X-Api-Key: YOUR_API_KEY_HERE

Replace {refNo} with the vacancy reference number (e.g. RS-1045).

Form fields

Field	Required	Type	Description
candidateName	✅	string (max 200)	Candidate's full name
candidateEmail	✅	string (max 200)	Candidate's email address
cv	✅	file	CV file. Accepted: .pdf, .doc, .docx. Max 10 MB
candidatePhone	❌	string (max 50)	Candidate's phone number
coverLetter	❌	string	Cover letter text
linkedInUrl	❌	string (max 500)	LinkedIn profile URL

Response

{
  "applicationId": 87,
  "message": "Application submitted successfully."
}

HTML form example

<form id="applyForm" enctype="multipart/form-data">
  <input type="text"  name="candidateName"  placeholder="Full Name"    required />
  <input type="email" name="candidateEmail" placeholder="Email"         required />
  <input type="tel"   name="candidatePhone" placeholder="Phone"                  />
  <textarea           name="coverLetter"    placeholder="Cover Letter"           ></textarea>
  <input type="url"   name="linkedInUrl"    placeholder="LinkedIn URL"           />
  <input type="file"  name="cv"             accept=".pdf,.doc,.docx"   required />
  <button type="submit">Apply Now</button>
</form>

Server-side only

This endpoint must be called from your server or a serverless function — never directly from the browser. See the Next.js example for a complete proxy implementation.

Viewing applications in Recsphere

Applications submitted via the API appear on the Applications tab within the vacancy detail view in the Recsphere portal.