# Partner: Ciphr \(HR System\) # 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 To enable the integration between Ciphr and Teamtailor, you connect your existing Ciphr account to Teamtailor through our [Marketplace](https://support.teamtailor.com/en/articles/2861357-teamtailor-marketplace) page. 1. Open your **Teamtailor** application and head over to the **Marketplace**. 2. Search for *Ciphr* and click **Activate**. 3. You will be redirected to the activation settings page. Fill in the fields below and click **Update** to complete the setup. ![](https://downloads.intercomcdn.com/i/o/c3b2d8b8e567c16a39d8495a5b1b2b3865dd4dc7/2689129122/06f76ce5d9c629b898f42beaef82/image.png?expires=1793902500&signature=0f1f1ad678ca48c452e6dcb8f6b93073224351c492349fe3b1746b483d606c9a&req=diYvH8h8lIBdW%2FMW1HO4zVhtgOFbWJCHhP02F8bwf5pLyIYSDh65r0RBBmKz%0AtRH5RZNW2d6YSZGjlak%3D%0A) - **Ciphr Base URL:** The web address of your Ciphr portal, for example **. - **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](https://support.teamtailor.com/en/articles/1475768-triggers) to the desired stage of your recruitment pipeline, for example your *Hired* stage. ![](https://downloads.intercomcdn.com/i/o/c3b2d8b8e567c16a39d8495a5b1b2b3865dd4dc7/2689133096/3886435bd8aaaf13e86342d22d49/image.png?expires=1793902500&signature=cfa8466670bf2471809ed296953364283df11b6b35877e8cd23e595773671979&req=diYvH8h9noFWX%2FMW1HO4zQrSmQ20v4Xrx9YUra7Wpxyx5JZZAj%2FJoICu6%2Fhr%0AooDQ6ridvfpaGx0LTZ4%3D%0A) - **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: 1. Open the candidate card in Teamtailor. 2. Click on **More** in the action bar and select **Add integrations**. 3. Select Ciphr and send the candidate. ![](https://downloads.intercomcdn.com/i/o/c3b2d8b8e567c16a39d8495a5b1b2b3865dd4dc7/2689140875/61b0191805c32f3445d56f620a2e/image.png?expires=1793902500&signature=297583cc4ca3776daa810c92ba354b6ad089c48a2a4fee6a76826675de307e1e&req=diYvH8h6nYlYXPMW1HO4zURy1ykawro%2FXbN6litP8vqwoAnrcXw4WEYrJTMv%0AhvD0VQipLQj1jofmigo%3D%0A) --- # 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. ![](https://downloads.intercomcdn.com/i/o/c3b2d8b8e567c16a39d8495a5b1b2b3865dd4dc7/2689138581/7aa1dc3611481c09bfef7789f99a/image.png?expires=1793902500&signature=b689080aa071ff65c9522e743b7206c64e08deea4aab2f88fc43b9d8c254750d&req=diYvH8h9lYRXWPMW1HO4zeN32cJflsDc%2BqQRMb3JROaSVFyTlQB0gWajFT%2Ft%0AmUg5Lz2ByQjKaYBYfnE%3D%0A) --- # 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](https://support.teamtailor.com/en/articles/3468522-custom-fields) to Ciphr fields. The mapping is done directly in the Ciphr activation settings: 1. Go to **Settings** > **Marketplace activations** and open **Ciphr**. 2. Click **Show advanced settings**. 3. 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. 4. Click **Update** to save your mapping. ![](https://downloads.intercomcdn.com/i/o/c3b2d8b8e567c16a39d8495a5b1b2b3865dd4dc7/2689134617/4ec61137d60e49e7ae11dbfb0cf5/image.png?expires=1793902500&signature=aae38c275e51043eeaf092394ad39d41fc0ad4ebbacc6d9e35c68f962592fdfb&req=diYvH8h9mYdeXvMW1HO4zSh2l99lAsIQ3ZZ9Ys5qjFGp9oHutlnWLw%2FM23vZ%0A7BMv%2BA9TI2%2BM%2FwNcMJg%3D%0A) **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: