Skip to main content
POST
/
jobs
/
{job_posting_id}
/
applications
Create Application
curl --request POST \
  --url https://api.talentunveiled.com/api/v1/jobs/{job_posting_id}/applications \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "first_name": "John",
  "last_name": "Doe",
  "phone_number": "+16505551234",
  "email": "john@example.com",
  "custom_fields": {
    "Notice period": "30 days",
    "Why this role?": "Looking for growth opportunities",
    "Years of experience": 7
  }
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "created_at": "2023-11-07T05:31:56Z",
  "candidate": {
    "first_name": "<string>",
    "last_name": "<string>",
    "phone_number": "<string>",
    "email": "jsmith@example.com"
  },
  "custom_fields": "<unknown>"
}

Authorizations

Authorization
string
header
required

API key authentication for public API, validated against WorkOS.

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

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.

Response

201 - application/json
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.