The Teamtailor x SAP SuccessFactors integration streamlines key hiring processes by connecting Teamtailor with SAP. It supports both requisition sync and on-hire triggers, helping you to manage candidate data more efficiently.
Requisition sync: Automatically imports requisitions from SAP into Teamtailor.
On-hire triggers: Transfers candidate data from Teamtailor to SAP for employee creation in Employee Central, candidate creation in the Recruiting Module, or onboardee creation in Onboarding 2.0.
Employee central module
Getting started – Activation Process
This integration requires a custom activation managed by Teamtailor’s Product Integrations team.
Request OAuth credentials
Ask your SAP administrator to generate OAuth credentials.
See SAP’s official documentation: Deprecation of Basic AuthenticationEncrypt credentials
Make sure all credentials are securely encrypted before sharing with Teamtailor.Submit credentials for activation
Share the encrypted credentials with your Customer Success Manager at Teamtailor.Specify your SAP module
Indicate which SAP module you are connecting:Employee Central
Recruiting
Onboarding 2.0 (API user permissions differ by module.)
Please note!
SAP is deprecating Basic Authentication:
Existing customers must migrate to OAuth by November 12, 2027.
New customers must use OAuth from the start.
If you’re still using Basic Authentication, SAP IAS isn’t required yet.
To connect with OAuth, you’ll use SAP IAS to generate the OAuth credentials. These are required for Teamtailor’s SAP SuccessFactors integration.
Integration Modules
Employee Central
When a candidate reaches a defined stage in your recruitment process (for example, Hired), a trigger connected to the SAP integration activates and sends candidate data from Teamtailor to SAP Employee Central.
Learn more about setting up triggers: Teamtailor Triggers Guide
API User Setup and Permissions
To enable the outbound data flow from Teamtailor to SAP, the integration requires an SAP API user with the following permissions:
Admin Center → Manage Permission Roles → Manage Integration Tools → Allow Admin to Access OData API through Basic Authentication (only needed with Basic Authentication, not with OAuth)
Manage Integration Tools → Admin access to OData API
Manage Integration Tools → OData API Attachment Export
Manage Integration Tools → OData API Attachment Import
Manage System Properties → Picklist Management and Picklists Mappings Setup
Data Creation in Employee Central
Once triggered, the integration automatically creates a new employee record in SAP Employee Central by inserting information into several entities in sequence:
User
PerPerson
EmpEmployment
PerPersonal
Entity | Field | Required |
User | First Name, Last Name | True |
PerPerson | Country, Date of Birth | True |
PerPerson | Place of Birth | False |
EmpEmployment | Start Date | False |
PerPersonal | First Name, Last Name, Nationality | True |
Please note!
The required fields can vary depending on your SAP environment.
For the full technical reference, see SAP’s guide: How to create an employee using OData APIs
Recruiting Module
With the SAP SuccessFactors Recruiting Module integration, you can automatically sync approved job requisitions from SAP to Teamtailor and create candidates in SAP directly when they’re hired in Teamtailor.
API User Setup and Permissions
The permissions required for the Recruiting Module are the same as for the Employee Central module, with the addition of Recruiting-specific OData permissions listed below.
Additionally required for Recruiting:
Recruiting Permissions → OData API Requisition Export
Recruiting Permissions → OData API Requisition Create
Recruiting Permissions → OData API Requisition Update
Recruiting Permissions → OData API Application Export
Recruiting Permissions → OData API Application Create
Recruiting Permissions → OData API Application Update
Recruiting Permissions → OData API Candidate Export
Recruiting Permissions → OData API Candidate Create
Recruiting Permissions → OData API Candidate Update
Recruiting Permissions → Candidate Tagging Permission
Requisition Sync (SAP → Teamtailor)
When a job requisition is approved in SAP, it’s automatically created as an approved requisition in Teamtailor. This allows recruiters to create a job from the requisition and manage candidates in Teamtailor.
Please note!
The integration does not support SAP Position Management.
Setup requirements
The requisition sync is configured via the SAP Integration Center together with Teamtailor’s Product Integrations team.
Activation typically takes 4–8 weeks, including mapping and testing.
To ensure a smooth setup, please provide:
SAP test account credentials (SuccessFactors test environment)
A field mapping document showing how fields in SAP correspond to Teamtailor fields
Details on how your SAP instance determines when a requisition is fully approved (this varies by customer)
Please note!
The location in SAP must match a location in Teamtailor.
The user creating the requisition in SAP must exist in Teamtailor with the same email address.
If no match is found, the requisition will be assigned to the Career Site Manager in Teamtailor.
On-Hire Flow (Teamtailor → SAP)
When a candidate reaches a defined stage in your recruitment process (for example, Hired), a trigger connected to the SAP integration activates and sends candidate data from Teamtailor to the SAP Recruiting Module.
Learn more about setting up triggers: Teamtailor Triggers Guide
If the requisition sync is active, the hired candidate will automatically be linked to the correct requisition in SAP.
If the sync is not active, you can still send candidates to SAP by adding the SAP requisition ID to the trigger configuration in Teamtailor.
Data Creation in Recruiting Module
Once the integration is triggered, Teamtailor sends the candidate data to SAP to create or update the corresponding entities in the Recruiting Module.
Entity | Field | Required |
Candidate | First Name, Last Name, Email, Phone, Country | True |
Candidate Light | Resume File | True |
Job Application | Job Requisition ID | True |
Please note!
The required fields can vary depending on your SAP configuration. Teamtailor’s Product Integrations team will review your environment to confirm which fields are mandatory.
Onboarding module
When a candidate reaches a defined stage in your recruitment process (for example, Onboarding), a trigger connected to the SAP integration activates and sends candidate data from Teamtailor to SAP Onboarding.
Learn more about setting up triggers: Teamtailor Triggers Guide
API User Setup and Permissions
The permissions required for the Onboarding Module are the same as for the Employee Central module, with the addition of the Onboarding-specific permissions listed below.
Additionally required for Onboarding 2.0:
Manage Onboarding Data: to create the onboardee and initiate the onboarding process
Manage Employee Data: to upsert the EmpJob, EmpEmployment, PerPerson and PerPersonal entities
Manage Foundation Objects: access to FOCompany, Location and LocationGroup
Read Picklists: to fetch and map picklist values
Read User Data: to look up managers by email
The API user also needs access to the following OData API endpoints:
POST /createOnboardee
POST /initiateOnboardingForUser
POST /upsert
GET /EmpJob, /User, /FOCompany, /PickListV2 and /Picklist
Data Creation in Onboarding Module
Once triggered, the integration automatically creates a new onboarding record in SAP. When a candidate is hired, the integration:
Creates an onboardee record in SAP (createOnboardee)
Upserts the employee data entities (EmpJob, EmpEmployment, PerPerson, PerPersonal)
Initiates the onboarding process (initiateOnboardingForUser)
Entity | Field | Required |
createOnboardee | userId, email, applicationId, workerClass, contractType, nativePreferredLang, nationality, jobStartDate | True |
EmpJob | company, userId, startDate, eventReason | True |
EmpJob | managerId, department, division, businessUnit, costCenter, jobTitle | False |
EmpEmployment | personIdExternal, userId, startDate | True |
PerPerson | personIdExternal, userId | True |
PerPerson | dateOfBirth, countryOfBirth, placeOfBirth | False |
PerPersonal | personIdExternal, firstName, lastName, nationality | True |
initiateOnboarding | userId, atsApplicationId, startDate | True |
Please note!
The required fields can vary depending on your SAP configuration. Teamtailor’s Product Integrations team will review your environment to confirm which fields are mandatory.
