> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://docs.intractive.app/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Ubeeo integration

# **Ubeeo integration**

With the Ubeeo integration you connect your Intractive story directly to your Ubeeo account. It makes applying for a job very smooth for the candidate, and it is a great way to boost a vacancy. As soon as someone fills in a form in your story, their details are sent straight to Ubeeo.

You can:
* Create a candidate profile in Ubeeo from any form in your story.
* Place that candidate directly in a vacancy of your choice.
* Add extra information, such as the name of the story, so you can always see where a candidate came from.
Everything is configured per story, so different campaigns can feed different vacancies and use different field mappings.

## **Before you start**
Make sure you have:
* Your three Ubeeo keys: a **Client ID**, a **Client Secret** and a **Vacancy feed token**. You can request these from Ubeeo support (see Step 3).
* At least one published vacancy in Ubeeo, so candidates can be placed in a job.

||| ⚠️Good to know: the Client ID, Client Secret and Vacancy feed token are private. Anyone who has them can send data to your Ubeeo account, so treat them like a password and never share them outside your team. Intractive always stores these credentials encrypted, which means you can no longer view them in Intractive after saving.

# **Step 1: Collect candidate details in your story**
The integration sends the data your story has collected, so first you need a form and variables to hold the answers. In this example we collect a first name, a last name and an email address.

1. In your story, add a content block **Form**.
2. Add the questions you want to ask. In this example: **first name**, **last name** and **email**.
3. Select **Logic** and create a **variable** for each question, then connect each question to its variable.

For example: form question 1 is connected to the variable `@first_name`, and the answer the candidate gives becomes the value of that variable.
![](https://storage.crisp.chat/users/helpdesk/website/-/a/f/c/4/afc4fa0dc4a39800/ubeeo-8_ojjkeh.png)
| 💡Tip: give your variables clear names (for example first_name, last_name) and ask for first name and last name as two separate questions. That way each answer can be sent to its own field in Ubeeo.

# **Step 2: Open the Ubeeo integration**
Once your form and variables are ready, you can connect your story to Ubeeo.

1. Go to your **Story**.
2. Open **Integrations**. Here you see all the integrations Intractive offers.
3. Select **Ubeeo**.

![](https://storage.crisp.chat/users/helpdesk/website/-/a/f/c/4/afc4fa0dc4a39800/ubeeo-1_b7owx2.png)
# **Step 3: Connect Ubeeo with your keys**
To connect, Intractive needs your **Client ID**, **Client Secret** and **Vacancy feed token**. Ubeeo creates these for you.
1. Ask Ubeeo support for the three keys. You can create a ticket in the Ubeeo support box, or send an email to <support@ubeeo.nl>.
2. Paste the **Client ID**, **Client Secret** and **Vacancy feed token** into the open fields in Intractive.
3. Test the connection straight away.
4. When you get the green light, click **Connect**.

Need more information? Take a look at the [Ubeeo ATS API documentation](https://api-docs.ubeeo.nl/).


![](https://storage.crisp.chat/users/helpdesk/website/-/a/f/c/4/afc4fa0dc4a39800/ubeeo-2_1heqtp2.png)

# **Step 4: Choose your variables and vacancy**
After connecting, you see the Ubeeo integration settings. Here you decide what is sent to Ubeeo and where the candidate lands.

1. **Select the variables** you want to send to Ubeeo. A checkmark appears when a variable is selected. Select them first, otherwise they can't be used in the next steps.
2. **Connect a vacancy** to this story. Use the search bar to find a vacancy that is published in Ubeeo and select it.

![](https://storage.crisp.chat/users/helpdesk/website/-/a/f/c/4/afc4fa0dc4a39800/ubeeo-3_1t4jc5u.png)
![](https://storage.crisp.chat/users/helpdesk/website/-/a/f/c/4/afc4fa0dc4a39800/ubeeo-4_19fepgt.png)

# **Step 5: Map your variables to Ubeeo fields**
Now you tell Intractive which answer belongs in which Ubeeo field.

1. Find the Ubeeo fields, such as **first name**, **last name** and **email**.
2. Connect each Ubeeo field to the matching variable from your story (for example `@first_name` to first name).
3. You can use as many Ubeeo fields as you need.
4. Hit save!


![](https://storage.crisp.chat/users/helpdesk/website/-/a/f/c/4/afc4fa0dc4a39800/ubeeo-5_109nj63.png)
![](https://storage.crisp.chat/users/helpdesk/website/-/a/f/c/4/afc4fa0dc4a39800/ubeeo-6_og97ij.png)

## **Custom fields (optional)**
Need to send something extra? You can add a **custom field** and fill it with a variable or with fixed text.
A handy example: add a custom field with the **name of your story** as text. Every candidate sent to Ubeeo then carries that field, so you can always see in Ubeeo that the candidate came from a story.

# **Step 6: Test your integration**
Check straight away whether everything works.
1. Create a **share link** for your story and open it.
2. Go through the story and fill in the form, as a candidate would.
3. Go back to the integration in Intractive and open **Integration activity**. Here you can see whether the integration works properly and whether the candidate was sent to Ubeeo.
4. Open Ubeeo and double check two things: the candidate profile has been created, and the candidate landed in the right vacancy.


![](https://storage.crisp.chat/users/helpdesk/website/-/a/f/c/4/afc4fa0dc4a39800/ubeeo-7_gllzlh.png)

## **Troubleshooting**
| **What you see** | **What to check** |
| ---- | ---- |
| The connection test fails | Check that the Client ID, Client Secret and Vacancy feed token were pasted in full, with no extra spaces. If it still fails, ask Ubeeo support to confirm your keys are active. |
| I can't find my vacancy | Only vacancies that are published in Ubeeo can be found. Check that the vacancy is published, then search again. |
| No candidate appears in Ubeeo | Check that the variables are selected (with a checkmark) and that the form questions are connected to those variables under Logic. Then open Integration activity to see whether a call was sent at all. |
| Fields arrive empty | The Ubeeo field isn't connected to a variable, or the form question isn't connected to that variable under Logic. |