# Хантфлоу API v2: POST /accounts/{account_id}/applicants — Создание кандидата

Также: `GET`/`PATCH`/`DELETE /accounts/{account_id}/applicants/{applicant_id}`.

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `account_id` | path | integer | да | ID организации |
| `first_name` | body | string | нет | Имя |
| `last_name` | body | string | нет | Фамилия |
| `middle_name` | body | string | нет | Отчество |
| `phone` | body | string | нет | Телефон |
| `email` | body | string | нет | Email |
| `position` | body | string | нет | Желаемая должность |
| `company` | body | string | нет | Компания |
| `money` | body | string | нет | Зарплатные ожидания |
| `birthday` | body | string | нет | Дата рождения |
| `photo` | body | integer | нет | ID фото |
| `externals` | body | array | нет | Резюме (одно): auth_type, account_source, data.body, files |
| `social` | body | array | нет | Соцсеть (одна): social_type (TELEGRAM), value |

## Базовые URL

- Боевой: `https://api.huntflow.ru/v2`
- Тестовый (песочница): `https://sandbox.huntflow.dev`
- Официальный Python-клиент Хантфлоу по умолчанию указывает хост .: `https://api.huntflow.ai`

## Авторизация

Тип: Bearer-токен

Токен создаётся в настройках Хантфлоу: «Настройки» → «API» → «Добавить токен»; выдаётся пара `access_token` и `refresh_token`. Все запросы передают заголовок `Authorization: Bearer <access_token>`.

- `access_token` действует 7 дней, `refresh_token` — 14 дней; если refresh-токен не использовать 14 дней, пару нужно создать заново.
- Истёкший токен даёт `401` с `type: authorization_error` и `detail: token_expired` — тогда вызывайте `POST /token/refresh`.

## Нюансы

- Почти все методы работают в контексте организации: `account_id` берётся из `GET /accounts`.
- ID этапов подбора — из `GET /accounts/{account_id}/vacancies/statuses`, причины отказа — из `/rejection_reasons`, источники резюме — из `/applicants/sources`.
- Для массовой выборки кандидатов удобнее курсорный поиск `search_by_cursor`.
- Есть также методы заявок на вакансии, мультивакансий, меток, справочников, регионов, подразделений, офферов, анкет, журнала действий (`action_logs`) и производственного календаря.

## Сценарии с этим методом

- [Добавить кандидата из формы на сайте на вакансию](https://mcp-everything.ru/integrations/huntflow/scenarios/dobavit-kandidata-iz-formy-na-sayte.md)

---

Если этого недостаточно — официальная документация: https://api.huntflow.ru/v2/docs
Вся интеграция одним документом: https://mcp-everything.ru/integrations/huntflow.md