---
title: "Create a New Candidate Application"
method: POST
path: "/postings/{uuid}/candidates"
tags: ["Application API"]
---

# Create a New Candidate Application

`POST /postings/{uuid}/candidates`

Operation is done on behalf of a candidate – they can access and edit the data, including attachments

## Path parameters

- `uuid` string, required

## Request body

- ApplyApiRequest — New candidate data
  - `firstName` string, required
  - `lastName` string, required
  - `email` string, required
  - `conditionalsIncluded` boolean — Specifies whether conditional questions should be returned in the response. 'false' if not specified
  - `phoneNumber` string
  - `location` Location — regionCode is not recommended to be used for countries other than the United States.
    - `country` string
    - `countryCode` string, required
    - `regionCode` string
    - `region` string
    - `city` string, required
    - `address` string, address
    - `postalCode` string
    - `longitude` string
    - `latitude` string
  - `web` Web
    - `skype` string
    - `linkedIn` string
    - `facebook` string
    - `twitter` string
    - `website` string
  - `tags` string[]
  - `education` Education[]
    - `institution` string
    - `degree` string
    - `major` string
    - `current` boolean
    - `location` string
    - `startDate` string, when — date in YYYY, YYYY-MM or YYYY-MM-dd format, ex. "2016", "2016-11", "2016-11-29"
    - `endDate` string, when — date in YYYY, YYYY-MM or YYYY-MM-dd format, ex. "2016", "2016-11", "2016-11-29"
    - `description` string
  - `experience` Employment[]
    - `title` string, required
    - `company` string
    - `current` boolean
    - `startDate` string, required
    - `endDate` string
    - `location` string
    - `description` string
  - `sourceDetails` SourceDetails
    - `sourceTypeId` string, required
    - `sourceSubTypeId` string
    - `sourceId` string, required
  - `resume` Attachment
    - `id` string, required
    - `name` string
    - `type` string
    - `contentType` string
    - `actions` object, required
      - `download` Action, required
        - `url` string, required
        - `method` 'GET' | 'POST' | 'PUT' | 'PATCH' | 'OPTIONS' | 'DELETE' | 'HEAD' | 'CONNECT', required
  - `avatar` Attachment
    - `id` string, required
    - `name` string
    - `type` string
    - `contentType` string
    - `actions` object, required
      - `download` Action, required
        - `url` string, required
        - `method` 'GET' | 'POST' | 'PUT' | 'PATCH' | 'OPTIONS' | 'DELETE' | 'HEAD' | 'CONNECT', required
  - `attachments` Attachment[]
    - `id` string, required
    - `name` string
    - `type` string
    - `contentType` string
    - `actions` object, required
      - `download` Action, required
        - `url` string, required
        - `method` 'GET' | 'POST' | 'PUT' | 'PATCH' | 'OPTIONS' | 'DELETE' | 'HEAD' | 'CONNECT', required
  - `answers` ScreeningQuestionAnswer[]
    - `id` string, required
    - `records` AnswerRecord[], required
      - `fields` object
  - `messageToHiringManager` string
  - `consent` boolean
  - `consentDecisions` object
  - `utmTracking` UtmTracking
    - `utmSource` string, required
    - `utmMedium` string
    - `utmCampaign` string
    - `utmTerm` string
    - `utmContent` string
  - `internal` boolean

## Response `200`

Successful request

- ApplyApiResponse
  - `id` string
  - `createdOn` string
  - `applicationId` string

## Other responses

- `400` — Invalid request
- `401` — Unauthenticated
- `429` — Too Many Requests
- `500` — Internal server error

---

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