Skip to main content
POST
Create Application

Authorizations

Authorization
string
header
required

API key authentication for the public API. Pass your API key as a Bearer token.

Path Parameters

job_posting_id
string<uuid>
required

Body

application/json
first_name
string
required
Required string length: 1 - 150
phone_number
string
required

Phone number in E.164 format (e.g. +16505551234, +66812345678).

Required string length: 1 - 20
last_name
string
default:""
Required string length: 1 - 150
email
string<email>
default:""
Minimum string length: 1
custom_fields
object | null

Free-form JSON object of customer-submitted data collected before the application reaches TalentUnveiled (e.g. answers from a pre-application funnel). Top-level must be a JSON object; any keys and value types are allowed inside. Max 64 KB serialized.

cv_url
string<uri> | null

Optional https URL to the candidate's CV (PDF). If provided, the CV is downloaded and processed asynchronously.

Response

id
string<uuid>
required
read-only
status
enum<string>
required
  • applied - Applied
  • screened - Screened
  • interviewed - Interviewed
  • shortlisted - Shortlisted
  • hired - Hired
  • rejected - Rejected
Available options:
applied,
screened,
interviewed,
shortlisted,
hired,
rejected
created_at
string<date-time>
required
read-only
candidate
object
required
custom_fields
any | null
required
read-only

Customer-provided custom fields submitted at application creation via the external API. Free-form JSON object. Top-level must be an object; inside, any keys/values are allowed. Max 64 KB serialized.