Here are the parameters you need to connect to SAP SuccessFactors API.
SuccessFactors API URL: e.g. https://apisalesdemo8.successfactors.com - see this for more info SAP SuccessFactors URLs
API Username: format is username@company_id, provide user access via: Admin Center >> Manage Permission Roles >> Manage Integration Tools >> Enable Allow Admin to Access OData API through Basic Authentication. OnRamp requires access to these entities: User, UserAccount, EmpJob, EmpEmployment, EmpEmploymentTermination, PerPerson, PerEmail
API Password: <api user’s password>
Here’s additional documentation from SuccessFactors https://help.sap.com/docs/SAP_SUCCESSFACTORS_PLATFORM/d599f15995d348a1b45ba5603e2aba9b/5c8bca0af1654b05a83193b2922dcee2.html?q=terminationdate . Though Basic Auth is deprecated, SAP SuccessFactors officially supports it until end of 2026. OnLink will support OAuth login well before this deadline. SuccessFactors recommends adding IP address restrictions with Basic Auth for additional security. Here are the Atlassian IP addresses you need to whitelist.
Mock credentials for your testing:
URL - https://3c3343b1-1498-4a6a-b63d-71aacb64c046.mock.pstmn.io
Username - sapuser@onwardb
Password - <contact us at support@onwardb.com>
SuccessFactors Webhook
SAP SuccessFactors comes with Intelligent Services events that provides capabilities for HTTP-based events. As a result, a number of HR events in SAP SuccessFactors can be pushed to target systems. OnLink leverages this functionality to receive event notifications and help automate various use cases such as Employee Hire, Employee Termination, Employee Changes, etc.
Here’s the official documentation on this approach: https://community.sap.com/t5/technology-blogs-by-sap/sap-integration-suite-advanced-event-mesh-using-sap-successfactors/ba-p/13558143
Before you begin
Follow instructions in our Webhook documentation to create a new Webhook for Success Factors. Select Basic Authentication and enter username and password (called Secret for Success Factors).
Step by step procedure to configure Webhook in Success Factors
In SuccessFactors, we need to set up an Intelligent Services New Hire Event to push data into OnLink. When you add a new employee, the Intelligent Services event will trigger and data will be pushed to OnLink.
Login to SuccessFactors as an admin user. Search for and select ‘Integration Center’ in the search box at the top right of the page.
On the next page, click on My 'Integrations'. Then click on ‘Create’ at the top right of the page to create a new Integration. Then select ‘More Integration Types’.
On the next page, select the values, as shown below, and click on ‘Create’.
Trigger Type - Intelligent Services
Source Type - SuccessFactors
Destination Type - Rest
Format - JSON
On the next page, select the ‘Employee Hire’ event from the list and click ‘Select’.
On the next page, provide a name and description for this integration.
On the next tab, configure the elements required for your payload by adding them one by one. Click on the + sign and select ‘Insert Sibling Element’. Add a label and description. Click on the 3-line menu button and select ‘Change Association’. Associate the elements with the column on the right. Add elements, and click ‘Next’.
On the next page, add any desired filters (optional). For example (below), if you were wanting to filter employees by country CHE only, then you can add this filter.
On the final page, add detail for OnLink URL and save it. Below are the values to be configured in ‘REST SERVER SETTINGS’:
Connection Name - Any Unique Name. Eg - OnLink-Webhook
REST API URL - Please paste the webhook URL which you have noted from the OnLink webhook integration tile in the previous section.
Authentication Type - Please select ‘Basic Authentication’
User Name - The userid which you have noted from the OnLink integration tile in the previous section.
Password - The secret which you have noted from the OnLink integration tile in the previous section.
HTTP Method - POST
Payload Format - JSON