Skip to main content
Ensure you have Admin privileges for your SAP SuccessFactors account with the Manage Integration Tools > Manage OAuth2 Client Applications permission.

​
Find your API Server

SAP SuccessFactors uses a different API server host for each data center. You look up the API server that corresponds to your tenant domain, and paste it into the API Server field in StackOne Hub.

  • Open the SAP SuccessFactors API server list (SAP note 2215682) and find your tenant domain in the table.
  • For example, if your domain is https://pmsalesdemo8.successfactors.com, look up salesdemo8 in the table.
  • Copy the value in the API Server column and remove the trailing forward slash.
  • Example: https://apisalesdemo8.successfactors.com

​
Find your username and Company ID

Your username and Company ID are both available from the account menu in the upper-right corner of SAP SuccessFactors.

1

Sign in and open the account menu

Sign in to your SAP SuccessFactors instance as an administrator, then select your profile image in the upper-right corner of the screen.

The profile image in the top-right shell bar of the SAP SuccessFactors home page, highlighted
2

Copy your username

In the account menu, your username is the value shown in parentheses next to your name. Copy it and paste it into the Username field in StackOne Hub.

  • Example: for a user shown as ‘John Smith (jsmith)’, the username is jsmith.
The SAP SuccessFactors account menu with the name and username in parentheses highlighted
3

Open version information

In the same account menu, select Show version information.

The account menu with the Show version information item highlighted
4

Copy your Company ID

In the About SuccessFactors dialog, locate and copy the Company ID. Paste it into the Company ID field in StackOne Hub.

  • Example format: SFPART123456
The About SuccessFactors dialog with the Company ID row highlighted

​
Register an OAuth2 client application

Register an OAuth2 client application in the Admin Center to obtain your API Key, X.509 certificate, and private key.

1

Open Manage OAuth2 Client Applications

In the top search bar, search for Manage OAuth2 Client Applications and select the matching result.

The action search showing the Manage OAuth2 Client Applications result highlighted
2

Register a new client application

Click Register Client Application.

The Manage OAuth2 Client Applications page with the Register Client Application button highlighted
3

Enter the application details

Enter an Application Name and an Application URL.

  • Application Name: StackOne Integration
  • The Application URL can be any valid URL and is not used in this integration.
The registration form with the Application Name and Application URL fields highlighted
4

Generate the X.509 certificate

SAP SuccessFactors generates the certificate for you. Click Generate X.509 Certificate.

The registration form with the Generate X.509 Certificate button highlighted
5

Enter a Common Name and generate

Enter a Common Name(CN) for the certificate, then click Generate.

  • Common Name(CN): StackOne OAuth2
The Self Assign a new X.509 Certificate form with the Common Name field and Generate button highlighted
6

Copy the X.509 certificate

Copy the entire value shown in the X.509 Certificate box. This is your x509 Certificate value — store it securely for use later, and paste it into the x509 Certificate field in StackOne Hub.

The registration form with the X.509 Certificate box highlighted and its value masked
7

Download the private key

Click Download to save the file containing your private key.

  • Caution: the downloaded file contains your private key — handle it securely.
  • Open the file and copy only the text between -----BEGIN ENCRYPTED PRIVATE KEY----- and -----END ENCRYPTED PRIVATE KEY-----, excluding the markers themselves.
  • This is your Private Key value — store it securely for use later, and paste it into the Private Key field in StackOne Hub.
The registration form with the Download button highlighted and the certificate value masked
8

Register the application

Click Register to save the client application.

9

Copy the API Key

Open the application by clicking View. The API Key is displayed above the X.509 Certificate. Copy it and paste it into the API Key field in StackOne Hub.

  • Note: copy this value immediately, as it may not be shown again.
The View OAuth Client Application screen with the API Key field highlighted and its value masked

​
Configure OData API permissions

Make sure the OData API entities you need are enabled for your instance.

  • Navigate to Admin Center > Company Settings > OData API Data Dictionary.
  • Verify that the entities you need — for example Employee, Candidate, JobRequisition, and JobApplication — are enabled for the OData API.
  • Enable Upsert operations if you need to update records (optional, and not available in all instances).

​
Find your Learning domain URL (optional)

Your Learning domain URL is required only for Learning or OCN actions, such as course import and completion tracking. This is the user-facing URL, not the API server URL. Leave the Learning Domain URL field blank if you only use HRIS actions.

  • Navigate to the Learning module in SAP SuccessFactors and look at the URL in your browser’s address bar.
  • Copy the base URL (everything before /learning).
  • Example: if your URL is https://salesdemo8.successfactors.com/learning/admin, your Learning domain URL is https://salesdemo8.successfactors.com
  • Note: the Learning domain URL has no api prefix, unlike the API server URL. Both use the same OAuth credentials.

​
Linking the Account from the Hub

1

Navigate to the Hub

Use one of the three Linking Account Methods to access the Hub.
2

Fill out the fields

Fill out the following fields using details from your provider:
  • API Server
  • Learning Domain URL (Optional)
  • Company ID
  • API Key
  • Username
  • Private Key
  • x509 Certificate
3

Connect

  • Click Connect
  • If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider’s authorization flow.
  • Once authorization is successful, you will see a confirmation popup

If the account linking is successful, you will see the newly linked account in your Accounts page.