> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SmartRecruiters Changelog

> Release history for the SmartRecruiters connector. Each version lists what changed and which actions were affected.

<Card title="SmartRecruiters connector" icon="arrow-left" href="/connectors/smartrecruiters" horizontal>
  Back to the connector overview, authentication methods, and actions.
</Card>

<Update label="v2.1.0" description="21 Sept 2026">
  `bug-fix` `new-feature`

  Fixed an action ID collision on list\_access\_groups, where the Configuration API and User API access-group endpoints shared one ID and the Configuration API copy was unreachable as a result. list\_access\_groups keeps its existing behaviour - the User API endpoint /user-api/v201804/access-groups with the users\_read scope - so callers are unaffected. The Configuration API endpoint /configuration/access-groups is now reachable as the new action list\_configuration\_access\_groups, which takes pageSize and pageId and needs configuration\_read.

  <AccordionGroup>
    <Accordion title="Added · 1 new action">
      `smartrecruiters_list_configuration_access_groups`
    </Accordion>

    <Accordion title="Changed · 3 actions updated">
      `smartrecruiters_get_access_group`, `smartrecruiters_list_access_groups`, `smartrecruiters_update_access_group`
    </Accordion>
  </AccordionGroup>
</Update>

<Update label="v2.0.0" description="14 Sept 2026">
  `breaking-changes` `new-feature`

  Enabled scheduled data sync on 22 list actions covering candidates, jobs, offers, users, access groups, interview templates and the configuration and reference lookups, so these collections can be kept in sync and read without calling SmartRecruiters on every request. Candidates, jobs and users sync incrementally using the existing updatedAfter filter; the rest refresh in full, because their endpoints expose only creation or release time filters. BREAKING - List Predefined Locations previously declared its page size input as limit, which SmartRecruiters ignores. It is now pageSize, the parameter the API actually accepts, so that endpoint paginates instead of returning every location on one page. Integrations passing limit to that action must send pageSize instead.

  <AccordionGroup>
    <Accordion title="Changed · 21 actions updated">
      `smartrecruiters_list_access_groups`, `smartrecruiters_list_approvals`, `smartrecruiters_list_candidate_properties`, `smartrecruiters_list_career_sites`, `smartrecruiters_list_departments`, `smartrecruiters_list_experience_levels`, `smartrecruiters_list_functions`, `smartrecruiters_list_hiring_processes`, `smartrecruiters_list_industries`, `smartrecruiters_list_interview_templates`, `smartrecruiters_list_job_properties`, `smartrecruiters_list_offer_properties`, `smartrecruiters_list_predefined_locations`, `smartrecruiters_list_rejection_reasons`, `smartrecruiters_list_system_roles`, `smartrecruiters_list_types_of_employment`, `smartrecruiters_list_users`, `smartrecruiters_list_withdrawal_reasons`, `smartrecruiters_search_candidates`, `smartrecruiters_search_jobs`, `smartrecruiters_search_offers`
    </Accordion>
  </AccordionGroup>
</Update>

<Update label="v1.2.1" description="11 Sept 2026">
  `bug-fix`

  Clarified how job reference fields work. create\_job and update\_job now state that industry, function, experienceLevel and typeOfEmployment take exact ids from the matching lookup action and that any other value is rejected, replacing wording that wrongly said unknown values are ignored. The job property actions now say they cover custom properties only and point to the lookup actions for the standard attributes.

  <AccordionGroup>
    <Accordion title="Changed · 4 actions updated">
      `smartrecruiters_create_job`, `smartrecruiters_get_job_property_values`, `smartrecruiters_list_job_properties`, `smartrecruiters_update_job`
    </Accordion>
  </AccordionGroup>
</Update>

<Update label="v1.2.0" description="11 Aug 2026">
  `new-actions`

  Add taxonomy lookup actions (list\_industries, list\_functions, list\_experience\_levels, list\_types\_of\_employment) for discovering valid IDs required by create\_job.

  <AccordionGroup>
    <Accordion title="Changed · 4 actions updated">
      `smartrecruiters_list_experience_levels`, `smartrecruiters_list_functions`, `smartrecruiters_list_industries`, `smartrecruiters_list_types_of_employment`
    </Accordion>
  </AccordionGroup>
</Update>

<Update label="v1.1.0" description="11 Aug 2026">
  `new-actions`

  Add taxonomy lookup actions (list\_industries, list\_functions, list\_experience\_levels, list\_types\_of\_employment) for discovering valid IDs required by create\_job. Breaking change — all action results now wrapped under a data key (result.data instead of result directly).
</Update>