Хантфлоу API v2: POST /accounts/{account_id}/applicants/{applicant_id}/vacancy — Добавление кандидата на вакансию

Смена этапа по уже добавленной вакансии — PUT по тому же пути.

Параметр	Где	Тип	Обяз.	Описание
account_id	path	integer	да	ID организации
applicant_id	path	integer	да	ID кандидата
vacancy	body	integer	да	ID вакансии
status	body	integer	да	ID этапа подбора
comment	body	string	нет	Комментарий
rejection_reason	body	integer	нет	ID причины отказа (для этапа отказа)
fill_quota	body	integer	нет	ID квоты (для этапа «вышел на работу»)
employment_date	body	string	нет	Дата выхода (для этапа «вышел на работу»)
files	body	array	нет	ID файлов, до 15
calendar_event	body	object	нет	Событие календаря (интервью)
email	body	object	нет	Письмо кандидату

Базовые 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