Хантфлоу 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://api.huntflow.ru/v2/docs Вся интеграция одним документом: https://mcp-everything.ru/integrations/huntflow.md