---
title: "/offers/:offer_slug/candidates"
method: POST
path: "/offers/{offer_slug}/candidates"
---

# /offers/:offer_slug/candidates

`POST /offers/{offer_slug}/candidates`

## Request

- Base URL: `https://yourcompany.recruitee.com/api`
- URL: `https://yourcompany.recruitee.com/api/offers/{offer_slug}/candidates`
- Auth: none required

Apply for the job offer (create candidate). By default, these fields are required: ```name```, ```phone```, ```email```, ```cv```. However, you can turn off the requirements for all of them (besides ```name``` and ```email```) in the offer's settings for the application form.

API also allows answering the job’s questions. You just need to attach a list of answers to the request.

## Path parameters

- `offer_slug` string, required

## Headers

- `Content-Type` string

## Request body

- object
  - `candidate` object
    - `name` string, required
    - `email` string, required
    - `phone` string
    - `remote_cv_url` string: Link to file saved on some external website. You can use candidate[cv] instead if you want to upload a file - see examples.
    - `referrer` string: Source of candidate. Shown as candidate's 'source' in the app

## Response `201`

201

- union
  - object
    - `candidate` object
      - `id` integer
      - `name` string
      - `emails` string[]
      - `phones` string[]
      - `created_at` string
      - `updated_at` string
      - `photo_url` string
      - `photo_thumb_url` string
      - `cv_url` string
      - `cv_pdf_url` string
      - `open_question_answers` unknown[]
        - unknown
  - object
    - `candidate` object
      - `id` integer
      - `name` string
      - `emails` string[]
      - `phones` string[]
      - `created_at` string
      - `updated_at` string
      - `photo_url` string
      - `photo_thumb_url` string
      - `cv_url` string
      - `cv_pdf_url` string
      - `open_question_answers` unknown[]
        - unknown

## Other responses

- `404`: 404
- `422`: 422

## Changes

- **2026-11-03** `eba11a5d1abc`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/recruitee/apis/careers-site-api/changes/offers/:offer_slug/candidates/post.md)

---

[API](https://skmtc.dev/recruitee/apis/careers-site-api.md) - [All operations](https://skmtc.dev/recruitee/apis/careers-site-api/llms.txt) - [OpenAPI document](https://skmtc.dev/recruitee/apis/careers-site-api/revisions/eba11a5d1abc?raw)