Articles on: Integrations

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.

💡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.


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.




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.



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!




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.




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.

Updated on: 17/10/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!