---
title: "Submit a candidate to an evergreen job"
method: POST
path: "/jobs/{jobId}/applications/submit"
tags: ["Job API:Job Applications"]
---

# Submit a candidate to an evergreen job

`POST /jobs/{jobId}/applications/submit`

## Path parameters

- `jobId` integer, required

## Request body

- SubmitJobOrderCandidateCommand
  - `source` string, nullable
  - `firstName` string, required
  - `lastName` string, required
  - `salutation` string, nullable
  - `email` string, required
  - `phone` string, nullable
  - `mobile` string, nullable
  - `address` SubmitAddressModel
    - `street` string[], nullable
    - `city` string, nullable
    - `state` string, nullable
    - `postalCode` string, nullable
    - `countryCode` string, nullable
  - `social` object, nullable
  - `employment` SubmitEmploymentModel
    - `current` SubmitCurrentEmploymentModel
      - `employer` string, nullable
      - `position` string, nullable
      - `workTypeId` integer, nullable
      - `salary` SubmitSalaryModel
        - `ratePer` 'Hour' | 'Day' | 'Week' | 'Month' | 'Year', string
        - `rate` number, double
        - `currency` string, nullable — Optional ISO 4217 3-letter alphabetic currency code
    - `ideal` SubmitIdealEmploymentModel
      - `position` string, nullable
      - `workTypeId` integer, nullable
      - `salary` SubmitSalaryRangeModel
        - `ratePer` 'Hour' | 'Day' | 'Week' | 'Month' | 'Year', string
        - `rateLow` number, double
        - `rateHigh` number, double, nullable
        - `currency` string, nullable — Optional ISO 4217 3-letter alphabetic currency code
      - `other` SubmitIdealSalaryModel[], nullable
        - `workTypeId` integer, nullable
        - `salary` SubmitSalaryRangeModel
          - `ratePer` 'Hour' | 'Day' | 'Week' | 'Month' | 'Year', string
          - `rateLow` number, double
          - `rateHigh` number, double, nullable
          - `currency` string, nullable — Optional ISO 4217 3-letter alphabetic currency code
    - `history` CandidateEmploymentHistoryModel[], nullable
      - `employer` string, nullable — Name of the employer
      - `position` string, nullable
      - `start` string, nullable — Year, month or date employment started.<br /> Year must be formatted as [ISO date-fullyear](https://www.rfc-editor.org/rfc/rfc3339.html#section-5.6), the 4 digit year the course was completed, e.g. 2017<br /> Month must be formatted as [ISO date-fullyear](https://www.rfc-editor.org/rfc/rfc3339.html#section-5.6) "-" [ISO date-month](https://www.rfc-editor.org/rfc/rfc3339.html#section-5.6), e.g. 2017-07<br /> Date must be formatted as [ISO full-date](https://www.rfc-editor.org/rfc/rfc3339.html#section-5.6), e.g. 2017-07-31
      - `end` string, nullable — Year, month or date employment finished, or "Present" for a current role.<br /> Year must be formatted as [ISO date-fullyear](https://www.rfc-editor.org/rfc/rfc3339.html#section-5.6), the 4 digit year the course was completed, e.g. 2017<br /> Month must be formatted as [ISO date-fullyear](https://www.rfc-editor.org/rfc/rfc3339.html#section-5.6) "-" [ISO date-month](https://www.rfc-editor.org/rfc/rfc3339.html#section-5.6), e.g. 2017-07<br /> Date must be formatted as [ISO full-date](https://www.rfc-editor.org/rfc/rfc3339.html#section-5.6), e.g. 2017-07-31
      - `description` string, nullable — Description of responsibilities and achievements.
  - `availability` SubmitCandidateAvailabilityModel — The date the candidate is available to start. Specify ONE OF immediate, relative or date.
    - `immediate` boolean — The candidate is available for an immediate start
    - `relative` SubmitRelativeStartModel
      - `period` integer
      - `unit` 'Week' | 'Month', string
    - `date` string, date, nullable — The specific date that a job starts or a candidate is available
  - `education` SubmitCandidateEducationModel[], nullable
    - `institution` string, nullable
    - `course` string, nullable
    - `date` string, nullable — Year, month or date completed.<br /> Year must be formatted as [ISO date-fullyear](https://www.rfc-editor.org/rfc/rfc3339.html#section-5.6), the 4 digit year the course was completed, e.g. 2017<br /> Month must be formatted as [ISO date-fullyear](https://www.rfc-editor.org/rfc/rfc3339.html#section-5.6) "-" [ISO date-month](https://www.rfc-editor.org/rfc/rfc3339.html#section-5.6), e.g. 2017-07<br /> Date must be formatted as [ISO full-date](https://www.rfc-editor.org/rfc/rfc3339.html#section-5.6), e.g. 2017-07-31
  - `skillTags` string[], nullable
  - `screening` SubmitScreeningQuesionResultsModel
    - `answers` SubmitScreeningQuesionAnswerModel[], nullable
      - `question` string, nullable
      - `answer` unknown
      - `score` integer, nullable — Optional score for this answer
    - `score` integer, nullable — Optional overall score for these screening results
  - `custom` SubmitJobApplicationCustomFieldsModel — Candidate and job application custom field values
    - `candidate` SubmitCustomFieldValueModel[], nullable — Candidate custom field values
      - `fieldId` integer, required
      - `value` unknown
    - `application` SubmitCustomFieldValueModel[], nullable — Job application custom field values
      - `fieldId` integer, required
      - `value` unknown

## Response `201`

Job application

- JobApplicationRepresentation
  - `applicationId` integer, required
  - `jobTitle` string, nullable
  - `jobReference` string, nullable
  - `manual` boolean
  - `source` string, nullable
  - `rating` integer, nullable
  - `status` JobApplicationStatusModel
    - `statusId` integer, required
    - `name` string, required
    - `active` boolean
    - `rejected` boolean
    - `default` boolean
    - `defaultRejected` boolean
    - `workflow` JobApplicationWorkflowModel
      - `stage` string, required — Name of the workflow stage
      - `stageIndex` integer, nullable — Position in the workflow
      - `step` integer, nullable — [Obsolete] Please reference stageIndex instead
      - `progress` 'Started' | 'InProgress' | 'Complete', string
  - `review` JobApplicationReviewModel
    - `stage` 'Submitted' | 'Viewed' | 'Accepted' | 'Rejected', string, required
    - `submittedAt` string, date-time, nullable
    - `submittedBy` UserNameModel
      - `userId` integer, required
      - `firstName` string, nullable
      - `lastName` string, nullable
      - `position` string, nullable
      - `email` string, nullable
      - `phone` string, nullable
      - `mobile` string, nullable
      - `inactive` boolean
      - `deleted` boolean
    - `reviewedAt` string, date-time, nullable
    - `reviewedBy` ContactNameModel
      - `contactId` integer, required — Unique identifier for the contact
      - `firstName` string, nullable — First name
      - `lastName` string, nullable — Last name
      - `position` string, nullable — Position or job title
      - `salutation` string, nullable — Salutation/honorific/title
      - `unsubscribed` boolean
      - `email` string, nullable — Primary email address
      - `phone` string, nullable — Phone number
      - `mobile` string, nullable — Mobile/cell number
      - `mobileNormalized` string, nullable — Mobile/cell normalized number
      - `inactive` boolean — Contact is no longer with the company
      - `status` StatusModel
        - `statusId` integer, required
        - `name` string, required
        - `active` boolean
        - `default` boolean
      - `owner` UserNameModel
        - `userId` integer, required
        - `firstName` string, nullable
        - `lastName` string, nullable
        - `position` string, nullable
        - `email` string, nullable
        - `phone` string, nullable
        - `mobile` string, nullable
        - `inactive` boolean
        - `deleted` boolean
  - `candidate` CandidateNameModel
    - `candidateId` integer, required — Candidate Id
    - `firstName` string, nullable — First name
    - `lastName` string, nullable — Last name
    - `email` string, nullable — Primary email address
    - `phone` string, nullable — Contact phone number
    - `mobile` string, nullable — Mobile/cell number
    - `mobileNormalized` string, nullable — Mobile/cell normalized number
    - `contactMethod` string, nullable — Preferred contact method
    - `salutation` string, nullable — Salutation/honorific/title
    - `unsubscribed` boolean
    - `address` AddressModel
      - `street` string[], nullable
      - `city` string, nullable
      - `state` string, nullable
      - `postalCode` string, nullable
      - `country` string, nullable
      - `countryCode` string, nullable
    - `status` StatusModel
      - `statusId` integer, required
      - `name` string, required
      - `active` boolean
      - `default` boolean
    - `rating` string, nullable — Internal rating of the candidate
    - `source` string, nullable — The source of the candidate
    - `seeking` 'Yes' | 'Maybe' | 'No', string
  - `job` JobOrderTitleModel
    - `jobId` integer, required
    - `jobTitle` string, nullable
    - `location` JobOrderLocationModel
      - `locationId` integer, required
      - `name` string, required
      - `area` JobOrderLocationAreaModel
        - `areaId` integer, required
        - `name` string, required
    - `company` CompanyNameModel
      - `companyId` integer, required — Unique identifier for the company
      - `name` string, nullable — Company name
      - `status` StatusModel
        - `statusId` integer, required
        - `name` string, required
        - `active` boolean
        - `default` boolean
      - `owner` UserNameModel
        - `userId` integer, required
        - `firstName` string, nullable
        - `lastName` string, nullable
        - `position` string, nullable
        - `email` string, nullable
        - `phone` string, nullable
        - `mobile` string, nullable
        - `inactive` boolean
        - `deleted` boolean
    - `contact` ContactNameModel
      - `contactId` integer, required — Unique identifier for the contact
      - `firstName` string, nullable — First name
      - `lastName` string, nullable — Last name
      - `position` string, nullable — Position or job title
      - `salutation` string, nullable — Salutation/honorific/title
      - `unsubscribed` boolean
      - `email` string, nullable — Primary email address
      - `phone` string, nullable — Phone number
      - `mobile` string, nullable — Mobile/cell number
      - `mobileNormalized` string, nullable — Mobile/cell normalized number
      - `inactive` boolean — Contact is no longer with the company
      - `status` StatusModel
        - `statusId` integer, required
        - `name` string, required
        - `active` boolean
        - `default` boolean
      - `owner` UserNameModel
        - `userId` integer, required
        - `firstName` string, nullable
        - `lastName` string, nullable
        - `position` string, nullable
        - `email` string, nullable
        - `phone` string, nullable
        - `mobile` string, nullable
        - `inactive` boolean
        - `deleted` boolean
    - `status` StatusModel
      - `statusId` integer, required
      - `name` string, required
      - `active` boolean
      - `default` boolean
    - `source` string, nullable
    - `owner` UserNameModel
      - `userId` integer, required
      - `firstName` string, nullable
      - `lastName` string, nullable
      - `position` string, nullable
      - `email` string, nullable
      - `phone` string, nullable
      - `mobile` string, nullable
      - `inactive` boolean
      - `deleted` boolean
  - `jobAd` JobAdSummaryModel
    - `adId` integer, required
    - `state` string, nullable
    - `title` string, nullable
    - `reference` string, nullable
    - `summary` string, nullable
    - `bulletPoints` string[], nullable
    - `owner` UserNameModel
      - `userId` integer, required
      - `firstName` string, nullable
      - `lastName` string, nullable
      - `position` string, nullable
      - `email` string, nullable
      - `phone` string, nullable
      - `mobile` string, nullable
      - `inactive` boolean
      - `deleted` boolean
    - `postAt` string, date-time, nullable
    - `expireAt` string, date-time, nullable
  - `submittedDetails` JobApplicationSubmittedDetailsModel
    - `firstName` string, nullable
    - `lastName` string, nullable
    - `email` string, nullable
    - `phone` string, nullable
    - `mobile` string, nullable
  - `screening` JobApplicationScreeningModel
    - `questions` JobApplicationScreeningQuestionModel[], nullable
      - `question` string, nullable
      - `answers` string[], nullable
      - `score` number, double, nullable
    - `score` number, double, nullable
  - `custom` CustomFieldValueModel[], nullable
    - `fieldId` integer, required
    - `name` string, required
    - `type` 'Text' | 'List' | 'Date' | 'Lookup' | 'Url', string, required — The type of value a custom field expects
    - `value` unknown
  - `partnerActions` PartnerActionStageModel[], nullable
    - `actionId` string, uuid
    - `actionName` string, nullable
    - `reference` string, nullable — Unique partner defined reference/identifier for the action
    - `stage` 'Submitted' | 'InProgress' | 'Completed' | 'Rejected' | 'Cancelled', string
    - `status` string, nullable — Partner defined progress status message for the action
    - `result` PartnerActionResultModel
      - `score` integer, nullable — Optional partner score for the action result
      - `url` string, uri, nullable — Optional partner defined URL for the action result
      - `urlType` 'Popup' | 'Page', string
    - `submittedAt` string, date-time
    - `submittedBy` UserNameModel
      - `userId` integer, required
      - `firstName` string, nullable
      - `lastName` string, nullable
      - `position` string, nullable
      - `email` string, nullable
      - `phone` string, nullable
      - `mobile` string, nullable
      - `inactive` boolean
      - `deleted` boolean
    - `updatedAt` string, date-time
    - `updatedBy` UserNameModel
      - `userId` integer, required
      - `firstName` string, nullable
      - `lastName` string, nullable
      - `position` string, nullable
      - `email` string, nullable
      - `phone` string, nullable
      - `mobile` string, nullable
      - `inactive` boolean
      - `deleted` boolean
  - `owner` UserNameModel
    - `userId` integer, required
    - `firstName` string, nullable
    - `lastName` string, nullable
    - `position` string, nullable
    - `email` string, nullable
    - `phone` string, nullable
    - `mobile` string, nullable
    - `inactive` boolean
    - `deleted` boolean
  - `createdBy` UserNameModel
    - `userId` integer, required
    - `firstName` string, nullable
    - `lastName` string, nullable
    - `position` string, nullable
    - `email` string, nullable
    - `phone` string, nullable
    - `mobile` string, nullable
    - `inactive` boolean
    - `deleted` boolean
  - `createdAt` string, date-time, nullable
  - `updatedBy` UserNameModel
    - `userId` integer, required
    - `firstName` string, nullable
    - `lastName` string, nullable
    - `position` string, nullable
    - `email` string, nullable
    - `phone` string, nullable
    - `mobile` string, nullable
    - `inactive` boolean
    - `deleted` boolean
  - `updatedAt` string, date-time, nullable
  - `links` JobApplicationLinks
    - `self` string, uri, nullable
    - `attachments` string, uri, nullable — Attachments

## Other responses

- `422` — Validation error

---

[API](https://skmtc.net/jobadder/apis/jobadder-api.md) · [All operations](https://skmtc.net/jobadder/apis/jobadder-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jobadder/jobadder-api/revisions/9f43f6a6ee6e/schema)