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, and join our Integration Ecosystem.
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 platform (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. The sandbox also gives access to the Integrations Hub you need to connect your integration to Teamtailor.
Note there is also the public **Teamtailor API -* which 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.
If you have a beta customer that you would like to test the integration with, you can reach out to [email protected] and we can help you activate the integration on the platform of the beta customer. Make sure to share the exact name of the customer’s Teamtailor platform.
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 Teamtailor can add the integration to our marketplace we perform a test of the integration, and we review the support documentation. To enter the test and review stage you can submit the below launch form. The time it takes for this stage to be completed depends on the existing launch queue, but generally takes 2-3 weeks from submitting the launch form.
Please fill out our Tech Partner Launch Form. We collect:
Note: you might be required to login to Google in order to upload the assets.
Make sure to complete the integration’s listing in the Integration’s Hub (in your Teamtailor sandbox). Read this article for instructions.
<aside> 👀 Teamtailor tests and 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>
Required marketing assets
The required marketing assets and support documentation are used in your listing on the Teamtailor marketplace (both the public and in-app marketplace.
The size of the logo’s doesn't matter, we resize them automatically. See below how we use the information
Public Marketplace
In-app marketplace
<aside> 💼 For integrations where the main purpose is to distribute job ads from Teamtailor into another platform, or to directly send applications from the job board 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. The sandbox also gives access to the Integrations Hub you need to connect your integration to Teamtailor.
Note there is also the public **Teamtailor API -* which 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.
If you have a beta customer that you would like to test the integration with, you can reach out to [email protected] and we can help you activate the integration on the platform of the beta customer. Make sure to share the exact name of the customer’s Teamtailor platform.
Q: Are there any costs associated with joining the Teamtailor Marketplace?
A: No. There are no fees to use our 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 (also in respect to data security). 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 request form being submitted and approved to receive access to your sandbox account. Note this can take longer from period to period.
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?