> For the complete documentation index, see [llms.txt](https://help.join.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.join.com/integrations/external-hr-tools/smartrecruiters.md).
# SmartRecruiters
Set up the SmartRecruiters integration to sync jobs to JOIN for multiposting and send applications back to SmartRecruiters. Learn setup steps, screening question support, source tracking, and more.
The SmartRecruiters integration lets you manage jobs and applications in one place. Jobs created in SmartRecruiters are automatically synced to JOIN and published across multiple job boards. When candidates apply, JOIN collects and forwards their applications directly into SmartRecruiters—so you can focus on hiring while JOIN handles the distribution.
{% hint style="warning" %}
Before you begin, make sure to review the [External HR tools](/integrations/external-hr-tools.md) article to understand the general requirements and limitations that apply to all integrations (e.g. sync frequency, job limits, multi-language/locations, screening questions).
{% endhint %}
Once connected, the SmartRecruiters integration allows you to:
* Sync jobs from SmartRecruiters to JOIN for multiposting
* Receive applications from JOIN directly into SmartRecruiters
* Manage your recruitment process entirely from SmartRecruiters
***
### Connect SmartRecruiters and JOIN
{% stepper %}
{% step %}
#### Find your SmartRecruiters subdomain
Your subdomain is required to activate the integration. You can find it in your SmartRecruiters API URL.
Example:\
If your URL is `https://api.smartrecruiters.com/v1/companies/YOURCOMPANY/postings`\
→ then your subdomain is `YOURCOMPANY`
{% endstep %}
{% step %}
#### Enter details in JOIN
1. Go to `Settings` → `Integrations` → `SmartRecruiters` in JOIN
2. Enter your SmartRecruiters subdomain
3. Click `Request` in the top-right corner
Our team will activate the integration within 1 business day and notify you by email once it’s live.
{% endstep %}
{% endstepper %}
### Screening questions
JOIN supports syncing screening questions from SmartRecruiters for the following field types:
* Short text (e.g. input text, text area)
* Number fields
* Yes/No (radio buttons mapped as single select)
* Multiple choice (multi-select or checkboxes)
* [Knockout questions](/jobs/job-creation.md#to-create-a-custom-screening-question) are not supported
{% hint style="info" %}
If you encounter issues with how questions or answers appear, please contact JOIN support so we can review your specific setup.
{% endhint %}
***
### Candidate source tracking
JOIN always sends source information with each application.
* In SmartRecruiters, the source will always appear as JOIN
* This is part of SmartRecruiters' fixed configuration and cannot be customised
***
### Job filtering
SmartRecruiters currently **does not support filtering** which jobs are synced to JOIN.
* All active jobs within your JOIN job limit may sync by default
* If you require more control over this, please contact JOIN Support to share feedback—we’re actively collecting use cases for future improvements
***
### FAQs
How does JOIN sync with SmartRecruiters?
Jobs sync from SmartRecruiters to JOIN every 30–60 minutes. Candidate applications are sent to SmartRecruiters in real time.
Where should I manage my job postings?
Always create, edit, and archive jobs in SmartRecruiters. JOIN mirrors the job data and should not be used for job management once synced.
Are screening questions supported?
Yes, JOIN supports several question types from SmartRecruiters: text, number, yes/no, and multiple choice. Knockout logic is not supported.
How is candidate source tracked in SmartRecruiters?
All candidates forwarded by JOIN are tagged with “JOIN” as the source. This setting is fixed in SmartRecruiters and cannot be changed.
Can I choose which jobs to sync from SmartRecruiters?
Not currently. JOIN will sync all active jobs within your plan’s job limit. Filtering is not officially supported.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://help.join.com/integrations/external-hr-tools/smartrecruiters.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
