Applications

Create application

Creates an application by linking an existing candidate to a job, with optional stage/CV. Use for sourcing workflows and manual application ingestion.

post/applications

Request

  • Base URL: https://api.100hires.com/v2
  • URL: https://api.100hires.com/v2/applications
  • Auth: HTTP bearer

Query parameters

includestring

Comma-separated list of related resources to include. Supported: candidate — full candidate profile, cv.text — parsed plain-text CV content, job — full job payload with url_backoffice for UI deep-linking.

Request body

candidate_idstring required

Candidate ID (numeric) or alias

job_idinteger required

Job ID to apply the candidate to.

stage_idinteger

Pipeline stage ID. If omitted, defaults to the first stage.

Response

Created application

idinteger required

Unique identifier

candidate_idinteger required

ID of the candidate

job_idinteger required

ID of the job

job_aliasstring nullable

Short alias of the job, usable in URLs (e.g. 79SZHfT)

internal_job_idstring nullable

Company's internal job identifier

company_idinteger required

ID of the company

url_backofficestring uri

Absolute backoffice URL of the application's view (candidate page in this job) in the 100Hires recruiter app. Use to render deep-links in agent UIs.

status'active' | 'hired' | 'rejected' required

Application status. Changes via hire/reject/unreject actions.

is_disqualifiedboolean required

Whether the candidate is disqualified for this application

rejected_atinteger nullable

Unix timestamp (seconds)

hired_atinteger nullable

Unix timestamp (seconds)

custom_fieldsobject nullable

Custom field values as key-value pairs

ai_scoreinteger nullable

AI-generated candidate fit score (0-100)

ai_recommendationstring nullable

AI-generated recommendation label (e.g. Strong, Good, Weak)

ai_scoring_updated_atinteger nullable

Unix timestamp (seconds) of the latest completed AI scoring result

created_atinteger required

Unix timestamp (seconds)

updated_atinteger required

Unix timestamp (seconds)

last_message_atinteger nullable

Unix timestamp (seconds) of the most recent message (email or SMS) sent to or received from the candidate in this application's company. Null if no messages exist.

days_since_last_messageinteger nullable

Number of whole days since the last message. Computed at request time. Null if no messages exist.

Example response

{
  "job_alias": "79SZHfT",
  "url_backoffice": "https://app.100hires.com/candidate/dtGeby2/79SZHfT",
  "job": {
    "alias": "79SZHfT",
    "language": "de-DE"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.