Toolset employer_misc

Employer directories, employers info, calls, webhooks.

25 tools. Mutations require an explicit confirm=true argument; Auth marks tools that need an hh.ru token.

Tool	Operation	Auth	Confirm	Description
dict_salary_areas	GET /salary_statistics/dictionaries/salary_areas	–	–	Regions, oblasts and cities dictionary for the salary statistics bank (public, no token needed).
dict_salary_employee_levels	GET /salary_statistics/dictionaries/employee_levels	–	–	Competence levels dictionary for the salary statistics bank (public, no token needed).
dict_salary_industries	GET /salary_statistics/dictionaries/salary_industries	–	–	Two-level dictionary of industries and activity spheres for the salary statistics bank (public, no token needed).
dict_salary_professional_areas	GET /salary_statistics/dictionaries/professional_areas	–	–	Professional areas and specialities dictionary for the salary statistics bank (public, no token needed).
employer_create_webhook_subscription	POST /webhook/subscriptions	yes	yes	Create a webhook subscription: body {"url": str, "actions": [{"type": str}]}. One url per application for all events; hh.ru POSTs event objects to the url (2xx or 409 expected). Delivery is best-effort, not guaranteed. Returns 201.
employer_delete_webhook_subscription	DELETE /webhook/subscriptions/{subscription_id}	yes	yes	Cancel a webhook subscription. Returns 204 on success.
employer_get_address	GET /employers/{employer_id}/addresses/{address_id}	yes	–	Get one employer address by id; with_manager adds the creator info.
employer_get_call_history	GET /calls/history	yes	–	Paginated (cursor-based) call history of the employer: site, app, QR, API-link and virtual-number calls. next_cursor/previous_cursor are mutually exclusive; their absence means the last/first page. with_records/with_transcripts embed media metadata into each call.
employer_get_call_link	GET /calls/link	yes	–	Time-limited call page link (expires_at) plus a Base64 SVG QR code for calling an applicant from hh.ru. The returned link_id is used in employer_get_call_history and the records/transcripts searches. vacancy_id is required for hiring managers.
employer_get_clickme_statistics	GET /clickme/statistics	yes	–	Statistics of Clickme advertising campaigns for a date range (inclusive); with_banners adds per-banner aggregation.
employer_get_salary_evaluation	GET /salary_statistics/paid/salary_evaluation/{area_id}	yes	–	Salary statistics report without forecasting (paid access to the salary bank required). Codes come from the four dict_salary_* tools; position_name lets the service derive speciality and level on its own; extend_sources widens the sample with resume/vacancy data when the bank is insufficient.
employer_list_active_vacancy_areas	GET /employers/{employer_id}/vacancy_areas/active	yes	–	Regions where the employer currently has active vacancies; values may change at any time.
employer_list_addresses	GET /employers/{employer_id}/addresses	yes	–	List employer addresses (paginated). changed_after returns all addresses changed since that moment (ISO 8601 with timezone, max 7 days back) with a deleted flag and without pagination; with_manager adds the creator info.
employer_list_available_publications	GET /employers/{employer_id}/services/available_publications	yes	–	Vacancy publication options (packages) for the employer, optionally filtered by area_id and professional_role_id. Pass a suitable package's employer_service_id when publishing a vacancy to spend it.
employer_list_departments	GET /employers/{employer_id}/departments	yes	–	Department dictionary of the employer; values may change at any time – do not hard-code them.
employer_list_payable_api_actions	GET /employers/{employer_id}/services/payable_api_actions/active	yes	–	Active paid API services of the employer (each purchased service is a separate item; empty items when none are active). See employer_get_manager_method_access for the access groups.
employer_list_tests	GET /employers/{employer_id}/tests	yes	–	Tests saved by the employer.
employer_list_vacancy_branded_templates	GET /employers/{employer_id}/vacancy_branded_templates	yes	–	Branded vacancy templates available to the employer (requires the paid branding service; values may change at any time).
employer_list_webhook_subscriptions	GET /webhook/subscriptions	yes	–	Webhook subscriptions of the current employer: each subscription has a url and a list of subscribed event types.
employer_search_call_records	POST /calls/records/search	yes	–	Fetch recordings of finished calls (a search, no confirm needed). body: exactly one of {"call_ids": [...]} (max 250, from employer_get_call_history) or {"link_ids": [...]} (max 50, from employer_get_call_link). record_url values are temporary links.
employer_search_call_transcripts	POST /calls/transcripts/search	yes	–	Fetch transcripts of finished calls (a search, no confirm needed). body shape is the same as in employer_search_call_records; each transcript carries a status and, when SUCCESS, a temporary transcript_url with an expires_at moment.
employer_update_webhook_subscription	PUT /webhook/subscriptions/{subscription_id}	yes	yes	Update url or actions of a subscription (send only the fields to change). actions replaces the whole list and cannot be empty. Returns 204.
get_employer	GET /employers/{employer_id}	–	–	Get public employer information by id, including trusted status, site url and the vacancies URL.
get_message_template	GET /message_templates/{template}	yes	–	Message templates for invitations and rejections (paid employer access). Pass either topic_id of an existing negotiation, or the vacancy_id + resume_id pair (never both). Template names: invite, invite_after_response, discard_after_response, discard_after_interview.
search_employers	GET /employers	–	–	Search hh.ru employers by text, region or type (public, no token needed). Pagination depth is limited to 5000 results; sort by name or open-vacancy count.