# Teamtailor

> Integrating HeyMilo with Teamtailor enables powerful conversational AI candidate engagement and screening capabilities within your hiring workflow. HeyMilo lets you automatically engage talent via SMS/WhatsApp/Email, automate resume screenings, and invite candidates to complete AI voice interviews so you can make more hires in less time.

## Agents Supported in Teamtailor

| SMS Agent                                                                                                                                                                                                                                                                            | Resume Agent                                                                                                                                                                                                                                                                                                                       | Voice/Video Agent                                                                                                                                                                                                                                                                                                                                                                                                                           |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ✅                                                                                                                                                                                                                                                                                    | ✅                                                                                                                                                                                                                                                                                                                                  | ✅                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| <p><strong>How does it work?</strong></p><p>As soon as candidates apply, they get a text from Milo with your questions. They respond directly in the thread, just like a real conversation. Once they finish, Milo sends over the voice or video interview invite automatically.</p> | <p><strong>How does it work?</strong><br>Please be advised that the data is not automatically pulled from ATS. You can add resume screening to your agent workflow once the integration is live and your job is connected. Candidates will then be asked to upload their resume to get screened for fit before moving forward.</p> | <p><strong>How does it work?</strong></p><p>After integration and job posting mapping, when a candidate applies to your Teamtailor job posting, the candidate's email address is pulled from the application form and the candidate is engaged through email to take the voice/video assessment. Once the candidate has completed it, the candidate's detailed assessment report is attached to their profile in the Teamtailor portal.</p> |

## Follow These Easy Steps to Set Up the HeyMilo Integration With TeamTailor

Watch this video, click through the interactive demo, and follow the steps below to learn how to connect HeyMilo in Teamtailor:

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbKCgmPgkC7X1VTl62ocK%2Fuploads%2FKrt9E17qaYhiTw2VDjB7%2FRachel%20Valentino_s%20Video%20-%20Jul%2021%2C%202025-VEED.mp4?alt=media&token=11640aa2-bbf7-4c24-a417-a5c38328ed43>" %}

{% embed url="<https://app.storylane.io/share/ajdp2d3j9zcz>" %}

{% stepper %}
{% step %} <mark style="color:blue;">**Step 1**</mark> Get your Teamtailor **API key** from your Teamtailor account

* Go to **Integrations** → **API Keys** → **New API key**

<img src="/files/PdsmGv6QTE0BFDOutPbk" alt="" data-size="original">
{% endstep %}

{% step %} <mark style="color:blue;">**Step 2**</mark> Name your API key, select API Scope as **Admin**, enable both **read** and **write** permissions.

* Copy the **API Key** generated

<figure><img src="/files/GcaHViQZjZh6pzDQT1Lf" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %} <mark style="color:blue;">**Step 3**</mark>**&#x20;Log in** to your HeyMilo Admin Dashboard

* Navigate to **Integrations**, and select **Teamtailor** from the list.
  {% endstep %}

{% step %} <mark style="color:blue;">**Step 4**</mark> Paste your **API key i**nto the Teamtailor API Key field and click **Connect**
{% endstep %}

{% step %} <mark style="color:blue;">**Step 5**</mark> Copy the Assessment **API Key** from HeyMilo and go to Teamtailor’s marketplace.

<figure><img src="/files/qNAxr355vmTTjMoJbVXE" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %} <mark style="color:blue;">**Step 6**</mark> Search for HeyMilo in the Teamtailor marketplace and paste the assessment API key here.

<figure><img src="/files/cQTLNbg2jtnjLOZAiW6n" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

## Map HeyMilo Agents to Your Teamtailor Jobs

To automatically trigger the correct screening agent for a given job:

{% stepper %}
{% step %} <mark style="color:blue;">**Step 1**</mark> Go to the Agents tab in your HeyMilo dashboard
{% endstep %}

{% step %} <mark style="color:blue;">**Step 2**</mark> Select the agent you want to link, click **View Configuration**, then scroll to **ATS Integration**
{% endstep %}

{% step %} <mark style="color:blue;">**Step 3**</mark> Choose **Teamtailor** as the ATS type
{% endstep %}

{% step %} <mark style="color:blue;">**Step 4**</mark> Select **Job ID** as the mapping parameter

<figure><img src="/files/mUCtFwi0kN0cEw5ggLTs" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %} <mark style="color:blue;">**Step 5**</mark> Copy and paste the Teamtailor job ID (from the job URL in your Teamtailor dashboard)

* Click **Add**, then **Save Configuration**. 🎉 You’re done!
  {% endstep %}
  {% endstepper %}

## Set Up a Trigger in Teamtailor

Now that your agent is mapped, you can create a trigger to launch the HeyMilo screening automatically.

{% stepper %}
{% step %} <mark style="color:blue;">**Step 1**</mark> In Teamtailor, open the job you want to automate
{% endstep %}

{% step %} <mark style="color:blue;">**Step 2**</mark> Go to the **Triggers** tab

<figure><img src="/files/gWE2ZCPQhO3g6nrpHdx9" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %} <mark style="color:blue;">**Step 3**</mark> Select the stage where you want to send the screening (e.g., Inbox or Applied)
{% endstep %}

{% step %} <mark style="color:blue;">**Step 4**</mark> Click **Add Trigger**, and in the HeyMilo interview dropdown, select HeyMilo Interview.

<figure><img src="/files/1MpXMXh27k8Ff7C28e7K" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %} <mark style="color:blue;">**Step 5**</mark> Additionally, you can toggle on the **Move candidate when complete**. Here based on the score, you can move the candidate to the new stage.

<figure><img src="/files/el48CK2dxWnKShWVTyfp" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %} <mark style="color:blue;">**Step 6**</mark> Your mapped agent will now run automatically when candidates reach that stage.
{% endstep %}
{% endstepper %}

## Review Candidate Results in Teamtailor

Once a candidate completes the HeyMilo screening, the results are pushed back to their profile:

* And, if any score was set in the trigger, the candidate will be automatically moved to the mentioned stage.

<figure><img src="/files/aHRCy0Uf7NPoNOFwirfz" alt=""><figcaption></figcaption></figure>

* ✅ AI-generated **score and summary**
* ✅ Full **transcript**
* ✅ Link to **recordings**

## **Details regarding the integration:**

| **Data Fields**                                                                                              | **Direction**              |
| ------------------------------------------------------------------------------------------------------------ | -------------------------- |
| When the trigger webhook is ignited, job details and candidate details are automatically pulled              | From Teamtailor to HeyMilo |
| When the candidate completes the interview, candidate’s score, report url , audio and video urls are pushed. | From HeyMilo to Teamtailor |

Hiring teams can quickly review evaluations, share internally, and make faster decisions without leaving Teamtailor.

## Additional resources

For additional information not covered here, reach out to <support@heymilo.ai>.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.admin.heymilo.ai/integrations/ats-integration/teamtailor.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.