Overview
Ciphr is an HR, payroll and people management platform, and Teamtailor's integration lets you automatically send new hires from Teamtailor into Ciphr as part of your onboarding process. Once a candidate reaches the stage you choose in Teamtailor, their details are created as an applicant in Ciphr, so your HR team can pick up onboarding without re-entering data.
How to get started
Please note!
Before activating the integration, reach out to Ciphr Customer Care and ask them to update your whitelisting settings for your account. This allows Teamtailor to complete the connection to Ciphr.
To enable the integration between Ciphr and Teamtailor, you connect your existing Ciphr account to Teamtailor through our Marketplace page.
Open your Teamtailor application and head over to the Marketplace.
Search for Ciphr and click Activate.
You will be redirected to the activation settings page. Fill in the fields below and click Update to complete the setup.
Ciphr Base URL: The web address of your Ciphr portal, for example https://customerportal.myciphr247.com.
Ciphr API Key: The API key for your Ciphr account. If you don't have one yet, reach out to your Ciphr contact.
ATS Integration ID (optional): An ID that Ciphr provides for your portal. It's used to send the candidate's CV to Ciphr.
Please note!
The ATS Integration ID is only needed for sending the CV. If you leave it empty, candidates are still created in Ciphr, just without their CV attached.
Once activated, you can find the Ciphr integration at any time under Settings > Marketplace activations, where you can update your credentials or custom field mapping.
How to use the integration
To start using the integration, add a trigger to the desired stage of your recruitment pipeline, for example your Hired stage.
ATS Integration ID (optional): If you work with more than one Ciphr portal, you can enter a different ID for this specific trigger. Leave it empty to use the value from the activation settings. When both are filled in, the value on the trigger is used.
Once you click Add trigger, the automation is set up. Every time a candidate is moved into this stage, they're created as an applicant in Ciphr.
If you prefer not to use automation, you can also send a candidate to Ciphr manually from a specific candidate card:
Open the candidate card in Teamtailor.
Click on More in the action bar and select Add integrations.
Select Ciphr and send the candidate.
What happens next?
Whether you send the candidate via a trigger or directly from the candidate card, their information is sent to Ciphr and a new applicant is created there. You can follow the status of the integration directly on the candidate card in Teamtailor.
What data is shared
The following candidate fields are sent from Teamtailor to Ciphr:
First Name (sent to Ciphr as Forenames)
Last Name (sent to Ciphr as Surname)
Phone (sent to Ciphr as Mobile Number)
Email (sent to Ciphr as Home Email Address)
Resume (sent to Ciphr as a CV document, when an ATS Integration ID is set)
Mappable custom fields
You can also send additional information to Ciphr, such as personal, contact and employment details, by mapping your Teamtailor candidate custom fields to Ciphr fields. The mapping is done directly in the Ciphr activation settings:
Go to Settings > Marketplace activations and open Ciphr.
Click Show advanced settings.
For each Ciphr field you want to use, select the Teamtailor custom field that holds that information. If you don't have a matching custom field yet, you can create one directly from here.
Click Update to save your mapping.
Please note!
Ciphr requires both a Title and a Sex for every applicant. If these custom fields are not filled in on the candidate, the integration sends Mr as the title and Unknown as the sex. We recommend mapping both fields so the correct values reach Ciphr.
The table below lists all Ciphr fields available for mapping:
Ciphr field | API-name | Field type |
Title | title | Select (Mr, Mrs, Miss, Ms) |
Former Surname | formersurname | Text |
Known As | knownas | Text |
Honours | honours | Text |
Date of Birth | dateofbirth | Date |
Address Line 1 | addressline1 | Text |
Address Line 2 | addressline2 | Text |
Address Line 3 | addressline3 | Text |
Address Line 4 | addressline4 | Text |
Post Code | postcode | Text |
Home Telephone Number | hometelephoneno | Text |
Sex | sex | Select (Male, Female, Unknown) |
NI Number | ninumber | Text |
Record Group Description | recordgroupdescription | Text |
Nationality | countrydescription | Text |
Ethnic Origin | ethnicorigindescription | Text |
Recruitment Source | recruitmentsourcedescription | Text |
Marital Status | maritalstatus | Select (Single, Married, Divorced, Widowed, Separated, Civil Partnership) |
Continuous Start Date | contstartdate | Date |
Probation End Date | probationenddate | Date |
Employee Notice Period | employeenoticeperiod | Text |
Employer Notice Period | employernoticeperiod | Text |
Work Permit Valid Until | workpermitvaliduntil | Date |
Need support?
Contact Teamtailor directly via:
Chat: click on the chat bubble on the right bottom corner from any Teamtailor page
Email: support@teamtailor.com