We’re excited that you want to integrate your solution with Teamtailor. Below you’ll find a step-by-step guide on how to integrate with Teamtailor.
Keep in mind that if you’re a tech partner you should follow the Tech partner Integration guide, and if you’re a job board you should follow the Job board Integration guide.
<aside> 🤝 For integrations where the main purpose is to provide additional benefits during the recruitment process (like sending an assessment or initiating an e-signature process), or for integrations where the main purpose is to send hired candidates into another software (like an onboarding or HR system)
</aside>
Fill out and submit the Tech Partner Integration form so the Tech Ecosystem team can create a record of your interest and learn more about your solution and goals for the partnership.
Before you fill out the form please have a look at our technical documentation, so that you know what kind of integration you want to build.
Use our Partner API to develop and test your integration. You'll receive a sandbox account after your application is approved. We will send the sandbox invitation to the contact that submitted the form.
Note there is also the public **Teamtailor API - w**hich is different from the Partner API.
<aside> 📅 Please update us on your planning for development via [email protected]. This allows us to provide better support during the development period.
</aside>
Before your integration can be officially launched, you’ll need to conduct (internal) testing on the entire customer flow.
Please note that Teamtailor can’t supply a beta customer for your testing purposes. This is to ensure that your team is familiar with the customer set-up process and that any potential issues are resolved before our customers onboard your integration.
Now that development is completed: Teamtailor requires support documentation - a support article and a screen recording to help our customers and internal teams better understand your solution and how to use it with Teamtailor.
We prefer the support article and video to be hosted online by you (e.g. on your website), so you can update the article when needed and so we can easily add the URL to your marketplace listing.
<aside> 👀
Note: without support documentation the integration can’t go live on the Teamtailor marketplace. You learn how to share the documentation with Teamtailor in step 6.
</aside>
Take a look at an example of a support article below, and read to minimal requirements to ensure the article is complete. All support documents and screen recordings will be reviewed by our Partnerships Team. Note: your article won’t be hosted on the Teamtailor support center, instead we prefer the support article and video to be hosted online by you.
Once the integration is completed, tested and the documentation has been created we require our Partners to sign our ‘Marketplace Agreement’. This agreement can be shared as soon as all steps above are completed. To get the agreement please send an email to **[email protected]** with the following info:
Before we can add you to our marketplace, we’d like to understand your positioning and core focus. This is also the moment to share marketing assets such as logo’s, your pitch, and the support documentation for the Teamtailor marketplace.
Please fill out our Tech Partner Launch Survey so that we can educate our internal teams on your solution. Note: you might be required to login to Google in order to upload the assets.
Share a test account (username & password) and login link for your platform. This allows us to do a full technical review.
Complete the integration’s listing in the Integration’s Hub (in your Teamtailor sandbox). Read this article for instructions.
<aside> 👀 Teamtailor reviews each integration. Fully completed integrations (step 1 - step 6) can be added to the marketplace by our team. Integrations do not automatically show in the marketplace.
</aside>
The required marketing assets and support documentation are used to create your listing on our public Teamtailor marketplace webpage, and within the integrations tab of the application.
Required brand assets
The size of the logo’s doesn't matter, we resize them automatically. See below how we use the information
<aside> 💼 For integrations where the main purpose is to distribute job ads from Teamtailor into Partner software, or to retrieve candidates from Partner software into Teamtailor
</aside>
Fill out and submit the Job Boards Integration form so the Tech Ecosystem team can create a record of your interest and learn more about your solution and the goals of the integration.
Before you fill out the form please have a look at our technical documentation, so that you know what kind of integration you want to build.
Use our Job Board API to develop and test your integration. You'll receive a sandbox account after your application is approved. We will send the sandbox invitation to the contact that submitted the form.
Note there is also the public **Teamtailor API - w**hich is different from the Jobboard API.
<aside> 📅 Please update us on your planning for development via [email protected]. This allows us to provide better support during the development period.
</aside>
Before your integration can be officially launched, you’ll need to conduct (internal) testing on the entire customer flow.
Please note that Teamtailor can’t supply a beta customer for your testing purposes. This is to ensure that your team is familiar with the customer set-up process and that any potential issues are resolved before our customers onboard your integration.
Now that development is completed: Teamtailor requires support documentation - a support article to help our customers and internal teams better understand your solution and how to use it with Teamtailor.
We prefer the support article and video to be hosted online by you (e.g. on your website), so you can update the article when needed and so we can easily add the URL to your marketplace listing.
<aside> 👀 Note: without support documentation the integration can’t go live on the Teamtailor marketplace.
</aside>
Once you’ve created and tested your channel you can notify us by completing the launch form below. We expect to receive the support documentation, and additionally a proof of concept. If your integration follows our policies, we will publish your channel so that our clients can start using it.
<aside> 👀 Teamtailor reviews each integration. Fully completed integrations (step 1 - step 5) can be added to the marketplace by our team. Integrations do not automatically show in the marketplace.
</aside>
Q: Are there any costs associated with joining the Teamtailor Marketplace?
A: No. There are no fees to use our open APIs or launch as a partner in our marketplace once all requirements have been completed.
Q: Do I need to build an integration with Teamtailor before joining the Marketplace as a partner?
A: Yes. To be published as a partner in our marketplace, there must be a viable integration between our two solutions that has been fully tested by each partner in their sandbox account. Additionally, the documentation and additional requirements in our onboarding guide above must be completed.
Q: What are the expectations for being a Teamtailor partner?
A: We rely on partners to scope and develop their integrations using the APIs and to use their sandbox account to fully test the integration before releasing it to customers. We expect partners to provide a positive customer experience by maintaining integration documentation, being responsive to any technical questions and making any relevant integration enhancements with our developer tools.
Q: How long does it take to receive a sandbox account?
A: It generally takes 1-2 weeks from the form being submitted and approved to receive access to your sandbox account.
Q: What technical support will I have access to during the integration process and as a partner?
A: The integration team can answer API questions and help troubleshoot errors. If you have any integration related questions or technical issues during development, please email [email protected]. To make sure we triage requests appropriately, we only offer email support at this time.
Q: What support will I get after the integration is live?