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

NameInTypeRequiredNotes
idpathintegerYesMinimum 1
firstNameformDatastringYesCandidate first name
lastNameformDatastringYesCandidate last name
emailformDatastringYesCandidate email
linkedinUrlformDatastringNoCandidate LinkedIn URL
headlineformDatastringNoCandidate headline
currentCompanyformDatastringNoCandidate current company
locationformDatastringNoCandidate location
phoneformDatastringNoCandidate phone number
githubUrlformDatastringNoCandidate GitHub URL
portfolioUrlformDatastringNoCandidate portfolio URL
personalSiteUrlformDatastringNoCandidate personal site URL
answersformDatastringNoJSON array of {questionId, answer}; FILE answers carry a file id from the files call
cvformDatafileNo
coverLetterformDatafileNo

Responses

  • 201 Application recorded
  • 400 Missing or invalid field
  • 404 The job does not exist or is not published
  • 409 The candidate already applied to this job
  • 429 Too many requests

Examples

curl
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'
Node
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
<?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;