Send an application to a published job
POST /v1/careers/jobs/{id}/applications
Permission needed: careers-site:apply
Limited to 60 calls per minute per key, on top of the limit on all calls.
Parameters
| Name | In | Type | Required | Notes |
|---|---|---|---|---|
id | path | integer | Yes | Minimum 1 |
firstName | formData | string | Yes | Candidate first name |
lastName | formData | string | Yes | Candidate last name |
email | formData | string | Yes | Candidate email |
linkedinUrl | formData | string | No | Candidate LinkedIn URL |
headline | formData | string | No | Candidate headline |
currentCompany | formData | string | No | Candidate current company |
location | formData | string | No | Candidate location |
phone | formData | string | No | Candidate phone number |
githubUrl | formData | string | No | Candidate GitHub URL |
portfolioUrl | formData | string | No | Candidate portfolio URL |
personalSiteUrl | formData | string | No | Candidate personal site URL |
answers | formData | string | No | JSON array of {questionId, answer}; FILE answers carry a file id from the files call |
cv | formData | file | No | |
coverLetter | formData | file | No |
Responses
201Application recorded400Missing or invalid field404The job does not exist or is not published409The candidate already applied to this job429Too many requests
Examples
curl -X POST 'https://api.novatalent.com/v1/careers/jobs/123/applications' \
-H "X-Api-Key: $NOVA_API_KEY" \
-F 'firstName=Ada' \
-F 'lastName=Lovelace' \
-F 'email=ada@example.com'const form = new FormData();
form.append('firstName', 'Ada');
form.append('lastName', 'Lovelace');
form.append('email', 'ada@example.com');
const response = await fetch('https://api.novatalent.com/v1/careers/jobs/123/applications', {
method: 'POST',
headers: { 'X-Api-Key': process.env.NOVA_API_KEY },
body: form,
});
console.log(response.status, await response.json());<?php
$curl = curl_init('https://api.novatalent.com/v1/careers/jobs/123/applications');
curl_setopt_array($curl, [
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['X-Api-Key: ' . getenv('NOVA_API_KEY')],
CURLOPT_POSTFIELDS => [
'firstName' => 'Ada',
'lastName' => 'Lovelace',
'email' => 'ada@example.com',
],
]);
$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
echo $status . " " . $response;