Integrate SAP SuccessFactors with Testlify

Follow these seven steps to connect SAP SuccessFactors to Testlify. You will locate your API domain and company ID, create a permission group and role, generate OAuth2 credentials, register Testlify as an assessment vendor, and activate event notifications.

Before you begin

• You must be an Admin of your SAP SuccessFactors instance. If you are not an admin, contact your SuccessFactors Admin to complete this setup on your behalf.
• The OData v2 API must be enabled on your instance. SAP enables it by default, so this usually requires no action.

Step 1: Find Your API Domain

Your API domain depends on the region where your SAP SuccessFactors instance is hosted.

1. Open the SuccessFactors API URLs list.

2. Filter for production environments (unless you are connecting a preview instance).

   

3. Find your region and copy the corresponding API domain. For example, Germany uses https://api012.successfactors.eu/.

   

   Tip: The API domain often mirrors your login domain. For example, if you log in at pmsalesdemo8.successfactors.com, your API domain is likely apisalesdemo8.successfactors.com. If you are unsure, contact your SAP representative or refer to the API URLs list above.

Step 2: Find Your Company ID

1. Click your profile picture in the top-right corner, then select Show version information.

   

2. Copy the value displayed next to Company ID.

   

Step 3: Create a Permission Group

1. In the search bar, enter Manage Permission Groups and open the result.

   

2. Click Create New.

   

3. Enter a name for the group. Click Pick a category and select Username.

   

4. Search for your user by username, tick the checkbox next to the user, then click Done.

Step 4: Create a Permission Role

1. In the search bar, enter Manage Permission Roles and open the result.

   

2. Click Create New.

   

3. Enter a name for the permission role.

   

4. Click Next and grant the required permissions.

   

   

5. Click Save, add the permission group you created in Step 3, grant access, then click Save again.

   

Step 5: Generate OAuth2 Client Credentials

1. In the search bar, enter Manage OAuth2 Client Applications and click the action.

   

2. Click Register Client Application.

   

3. Enter a name and any valid URL for the application (e.g., https://example.com). Check Bind to Users and click OK.

   

4. Enter the USERID of the admin user you added to the permission group in Step 3.
5. Do not click Generate X.509 Certificate. Instead, open the Testlify integration settings page and copy the X.509 certificate that Testlify provides there.
6. Paste the certificate into the field and click Register.
7. Click View in the top row to open the registered application.

8. Copy the API Key displayed on the page.

   Tip: Save your API Key in a secure location before continuing — you will need it in the Testlify connection flow and it cannot be retrieved after you leave this page.

9. Paste the API Key and API username into the Testlify connection flow to complete authentication.

Step 6: Set Up Assessment Vendor

1. In SAP SuccessFactors, navigate to Manage Assessment Vendors.
2. Click Export to download the existing vendor list in .csv format.
3. Open the downloaded file and add a new row for Testlify with these values:
   • externalPartnerCode: TESTLIFY
   • clientId: TESTLIFY

4. Return to Manage Assessment Vendors and import the modified file.

   

5. In your Provisioning space, navigate to Import/Export Assessment Vendor Packages.
6. Download the template file, add a single row with these values, then import it:
   • vendorId: TESTLIFY (or the vendor ID you created)
   • packageCode: 123
   • reportPackageCode: TESTLIFY
   • shortName: Testlify

7. Add Testlify to the languages you use.

   

Step 7: Set Up Event Notification

1. Go to the Event Notification Subscription page and add a new subscriber with these details:

   • Category: Customized
   • Subscriber ID: TESTLIFY
   • Name: TESTLIFY
   • Group: Leave empty
   • Client ID: TESTLIFY

   

2. On the External Event tab, add an event with these settings:

   • Event Type: rcm_assessment_alert_v2
   • Subscriber: TESTLIFY
   • Protocol: SOAP_OVER_HTTP_HTTPS
   • Endpoint URL: Enter the subscription URL from your Testlify integration settings page
   • Authentication: Basic
   • User: Your username
   • Password: Your password
   • Leave all remaining fields empty.

   

   

Need help? Contact support.