Skip to main content

SmartRecruiters connector

Back to the connector overview, authentication methods, and actions.
​
21 Sept 2026
bug-fix new-featureFixed 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.
smartrecruiters_list_configuration_access_groups
smartrecruiters_get_access_group, smartrecruiters_list_access_groups, smartrecruiters_update_access_group
​
14 Sept 2026
breaking-changes new-featureEnabled 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.
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
​
11 Sept 2026
bug-fixClarified 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.
smartrecruiters_create_job, smartrecruiters_get_job_property_values, smartrecruiters_list_job_properties, smartrecruiters_update_job
​
11 Aug 2026
new-actionsAdd taxonomy lookup actions (list_industries, list_functions, list_experience_levels, list_types_of_employment) for discovering valid IDs required by create_job.
smartrecruiters_list_experience_levels, smartrecruiters_list_functions, smartrecruiters_list_industries, smartrecruiters_list_types_of_employment
​
11 Aug 2026
new-actionsAdd 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).