Tellent (Recruitee) integration

With the Recruitee integration you connect your Intractive story directly to your Recruitee (Tellent) account. As soon as someone fills in a form in your story, their details are sent straight to Recruitee. You can:

• Create a candidate in Recruitee from any form in your story.
• Add that candidate to a specific job vacancy automatically.
• Tag candidates so you always know which story or campaign they came from.

Everything is configured per story, so different campaigns can feed different vacancies, use different field mappings and carry their own tags.

Before you start

Make sure you have:

• An active Intractive account with a story you can edit.
• Permission in Recruitee to view your Company ID and to create a personal API token. If you don't have this, ask a Recruitee admin in your organisation.
• At least one published vacancy in Recruitee, if you want candidates to be linked to a job automatically.

It's also good to know that the API token is created at the individual user level. If this user account is deactivated, the API token will also be deleted. To avoid this, use a generic user in Recruitee. For example, add a user with a generic email address (hr or integrations@company.com) named "HR" or "Integrations," and create the personal API token for that user account.

Step 1: Connect Recruitee to Intractive

1.1 Open the integration in Intractive

1. Log in to Intractive.
2. Go to your Story.
3. Open Integrations.
4. Click Recruitee. You'll see two fields: Company ID and Personal API token.

1.2 Get your Company ID and API token from Recruitee

1. Open Recruitee.
2. Go to Apps and plugins → Personal API tokens.
3. Copy your Company ID from this page. (You can also find it under your company settings.)
4. Create a new token. A personal API token is a unique code that lets Recruitee connect to another system.
5. Give the token a clear, recognisable name — for example Intractive — so you can always tell later which token belongs to which piece of software.
6. Copy the API token.

1.3 Fill in the details and test the connection

1. Go back to Intractive.
2. Paste your Company ID and Personal API token into the Recruitee integration fields.
3. Click Test connection to check the credentials straight away.
4. If the test succeeds, Recruitee is connected.

Step 2: Collect candidate details in your story

The integration sends data that your story has collected, so first you need a form and variables to hold the answers.

1. In your story, add a form so viewers can leave their details.
2. Add the fields you want to collect. In this example the form has two fields: name and email.
3. Click Logic to link each filled-in field to a variable.

Those variables can be used in two ways:

• Inside the story itself: you can show an answer back to the viewer later on. To insert a variable, use the format {{@variable}} in any text field. In this example we created two variables, name and email, so we can reuse them in later story blocks. Once the viewer has filled in the form, adding {{@name}} or {{@email}} to a text field will display the value they entered.
• Inside an integration: the value is passed on to a system like Recruitee.

Step 3: Send the data to Recruitee

Once the connection is live, you decide what should happen in Recruitee. There are three actions available, and you can combine them:

• Create a candidate: creates a new candidate profile from your story variables.
• Apply to job: links that candidate to a vacancy of your choice.
• Add a tag: adds a tag to the candidate profile so you can trace where they came from.

Action 1: Create a candidate

1. Enable the Create candidate step in Intractive.
2. Open the candidate field mapping and connect each story variable to the matching Recruitee field. Several fields are available, so you can send more than just name and email.

Before a candidate can be created, check your trigger conditions:

• Tick the variables that apply. When one of those variables is updated, the action is triggered.
• 

Action 2: Apply to job

Action 3: Add a tag

If you also want a tag on the candidate profile, enable the third step. The tag you create here is visible on the candidate profile in Recruitee.

You can check straight away whether the connection is working.

1. After you have saved the integration, refresh your Intractive platform page. This is easy to forget and is the most common reason a test seems to fail.
2. Publish your story and open the link, or refresh the story page if the story was already published.
3. Fill in the form as a candidate would and submit it.
4. In Intractive, click Integration activity. Here you can see which calls were made and what was sent. A call that arrived correctly gets the label Delivered. A call that failed gets the label Failed — click on it to see what went wrong and where the problem is.
5. Open Tellent Recruitee and check that the candidate is there and, if you used Apply or Create match, that they are linked to the right vacancy.

Troubleshooting

Updated on: 24/09/2026