---
title: "Create a candidate"
method: POST
path: "/candidate"
tags: ["Candidate"]
---

# Create a candidate

`POST /candidate`

curl request example
curl --location --request POST 'https://hurma.work/api/v1/candidate' \
--header 'token: 886308a96833251c04ee18fff519a7aa15073256d6a5460587bd892e40e58c53d0dcab74cdde736' \
--form 'name='Stepan Andriyovych'' \
--form 'phone='phone'' \
--form 'email='email@email.com'' \
--form 'description='Additiona info'' \
--form 'hurma_vacancy_id='1'' \
--form 'cv=@'/home/user/downloads/StepanAndriyovych-cv.pdf''

## Headers

- `token` string, required

## Request body

- CandidateCreate — Candidate data structure
  - `name` string, required — Full name
  - `phone` string, nullable — Phone number
  - `email` string, nullable — Email
  - `description` string, nullable — Description
  - `hurma_vacancy_id` integer, nullable — Vacancy id
  - `cv` string, binary, nullable — File
  - `position` string, nullable — Position
  - `birth_date` string, nullable — Format Y-m-d
  - `sex` string, nullable — 0 - no selected, 1 - men, 2 - women
  - `skype` string, nullable — Skype
  - `linked_in` string, nullable — Link to profile
  - `telegram` string, nullable — Telegram nick
  - `current_job` string, nullable — Current job
  - `job_comment` string, nullable — Job comment
  - `education` string, nullable — Education
  - `residence` string, nullable — Residence
  - `relocate` string, nullable — 0 - false, 1 - true
  - `duties` string, nullable — Duties
  - `additional_info` string, nullable — Additional info
  - `custom_properties` union[], nullable — Custom properties
    - union
      - ApiV1CandidateCustomPropertyItemArray — custom property array value
        - `id` integer
        - `value` union[], nullable
          - union
            - string
            - integer
      - ApiV1CandidateCustomPropertyItemString — custom property string value
        - `id` integer
        - `value` string, nullable
      - ApiV1CandidateCustomPropertyItemInteger — custom property integer value
        - `id` integer
        - `value` integer, nullable

## Response `200`

ОК

- CandidateCreateResponse — Candidate creation result
  - `result` string
  - `error` boolean
  - `code` integer
  - `messages` string[]

## Other responses

- `403` — Forbidden
- `422` — Invalid request parameters

---

[API](https://skmtc.net/hurma/apis/hurma-public-api-v1-endpoints.md) · [All operations](https://skmtc.net/hurma/apis/hurma-public-api-v1-endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hurma/hurma-public-api-v1-endpoints/versions/c2e35a68e512/schema)