Recruitee

Recruitee calls a job an offer, and the same endpoint creates either a real job or a talent pool.

Access

Recruitee is BYOK-only. Connect your own Recruitee token and your company (the acme in acme.recruitee.com, or the numeric company ID) in Integrations; there is no managed-key fallback and the write costs 0 Hyreflow credits. A Recruitee token is personal and per-company: it carries exactly the permissions of whoever minted it, and acts in their name. list_departments is the free connection check: it verifies the key and returns the departments a department_id comes from.

Create an offer

create_job(payload) posts an offer. Required: title, description, location_ids, and requirements (optional when kind is talent_pool).

• title (required) — the offer title.
• description (required) — the offer description.
• location_ids (required) — array of Recruitee location ids, required even for a remote role.
• requirements — required for a job, optional for a talent pool.
• kind — job (default) or talent_pool.
• department_id — assigns the offer to an existing department.
• on_site / hybrid / remote (one of them required) — the work model shown on the careers site. At least one must be true; none of the three defaults to true.
• visibility_options — defaults to ["locations_question"], adding a location picker to the application form.
• locations_question / locations_question_type (single_choice default or multiple_choice) / locations_question_required.

hyreflow tools execute recruitee_create_job --payload '{
  "title": "Senior Platform Engineer",
  "location_ids": [12345],
  "description": "<p>Own the deployment platform.</p>",
  "requirements": "<p>Kubernetes, CI/CD pipelines, five years of platform work.</p>",
  "hybrid": true
}'

The offer id is offer.id; offer.slug is what appears in the careers URL.

Where location_ids comes from

They are numeric Recruitee location ids, and list_locations returns them for free — search by city or name with query and use each match's id. A new account starts with one location; add others under Settings → General → Locations. There's no way to pass a location as a string on create.

Gotchas

• Recruitee documents no validation-error shape. If a create fails, re-check title, description, requirements, location_ids, and that one of on_site/hybrid/remote is true.
• kind is the only thing separating a job from a talent pool — read it back before executing.
• This is a write into the customer's own ATS — confirm the payload before executing.

What creating an offer does NOT do

Recruitee's API accepts none of salary, employment type, category, experience, education, hours, pipeline template, open questions, followers, hiring managers, or status on create — those are read-only on the response and set inside Recruitee. Whether a fresh offer lands as draft or published isn't part of Recruitee's documented contract either.

Publishing it

A created offer is a draft. set_job_state(offer_id) takes it live on the careers site:

hyreflow tools execute recruitee_set_job_state --payload '{"offer_id": 567441}'

state also accepts draft, closed and archived. Recruitee moves an offer with a per-transition endpoint rather than a writable status field, so status stays read-only on the offer itself.