Mapping Teamtailor custom fields to Oneflow data fields

Angelica Angelis
Angelica Angelis
  • Updated

You can now map Teamtailor custom fields to Oneflow data fields. This article covers the three key parts of the custom field management process:

Set up Teamtailor custom fields

NOTE

The Oneflow admin email is required to map Teamtailor custom fields to Oneflow data fields. You can configure the admin email on the Teamtailor settings page. If the admin field is empty, Teamtailor will use the recruiter for which you opened the configuration. However, this is only required if there are any pending custom fields to map.

Teamtailor settings configuration

The setup process consists of the following steps:

  1. Log in to Teamtailor as an administrator, then go to Settings → Custom fields.
  2. On the Candidates tab, click on + New custom field to create a new custom data field that you want to access in Oneflow contracts. Alternatively, select an existing custom data field.

INFORMATION

Custom fields can only be created while on the Candidates tab. You cannot create custom fields from the Jobs tab.

Creating a new custom field in Teamtailor
  1. In the API name field, add the "oneflow-" prefix to the custom field, as shown below.
Setting the API name with prefix
  1. Click Save to save your custom data field.
  2. After saving the custom data field, you must create a new Oneflow contract via Teamtailor to trigger the synchronization. You only need to do this once when you create a new custom data field.

NOTE

When you save a custom data field in Teamtailor, it won’t automatically show up in your Oneflow account. You must create a Oneflow contract via Teamtailor first; only then will the custom data field be linked between the two systems. Once it’s linked, you can use the custom data field in your Oneflow templates.

That’s it! You can now use this custom data field value in your Oneflow contracts.

Custom data field successfully created

How to use custom data fields in Oneflow

Now that you have the custom data field set up in Teamtailor, it’s available in your Oneflow contracts and templates.

To use your custom data field:

  1. In Oneflow, open a contract and edit an existing form field or add a new one.
  2. Click the Edit icon, and in the Edit field menu > Data field, select your custom field from the list. The data field value will be prepopulated in the selected form.
Selecting custom field in Oneflow editor

Delete custom fields

To remove a custom field, remove the "oneflow-" prefix in the custom field settings. Next time you open the integration configuration, Teamtailor will request to remove these data fields.

NOTE

If a user deletes a custom field in Teamtailor, it will also be removed from Oneflow. However, the deleted data fields will still be visible until the user creates the next contract.

Was this article helpful?

0 out of 0 found this helpful

Have more questions? Submit a request