Skip to main content

Set up a connection to SAP SuccessFactors

Stephen Brandt
  • Updated
SAP SuccessFactors is a cloud-based human capital management system. Celigo connector for SAP SuccessFactors enables you to integrate with:
  • Employee Central Payroll
  • Compensation Information
  • Foundation
  • Employment Information
  • Personal Information

SAP SuccessFactors documentation: API guide, Authentication, ODATA reference guide
Additional reference: Supported SAP SuccessFactors APIs

A. Set up an SAP SuccessFactors connection

Start establishing a connection to SAP SuccessFactors in either of the following ways:

  • From the Resources menu, select Connections. Then, click + Create connection at the top right.
        – or –
  • While working in a new or existing integration, you can add an application to a flow simply by clicking Add source or Add destination/lookup.

In the resulting Application list, select SAP SuccessFactors.

The Create connection pane opens with required and advanced settings.

B. Describe the SAP SuccessFactors connection

Edit the General settings specific to your account and this connection resource.

Name (required): Provide a clear and distinguishable name. Throughout integrator.io imports and exports, you will have the option to choose this new connection, and a unique identifier will prove helpful later when selecting among a list of connections that you’ve created.

Application (required, non-editable): A reminder of the app you’re editing.

C. Supply required SAP SuccessFactors account information

At this point, you’re presented with settings for providing SAP SuccessFactors authentication:

Base URL (required): Paste your unique base URL for SAP SuccessFactors. If your instance is located at https://pmsalesdemo8.successfactors.com, then enter apipmsalesdemo8.successfactors.com. For more information on data center and API servers, see List of SAP SuccessFactors API Servers.

Client ID (required): Enter the API key provided when you register an OAuth 2.0 client application with SAP SuccessFactors (see below).

User ID (required): Enter your SAP SuccessFactors user ID.

Company ID (required): Enter your company ID, which you can find when signed into your account by clicking the avatar at the top right and selecting Show version information.

SAML assertion (required): Paste the SAML assertion for, which you can generate using the private key (see below) provided with your OAuth 2.0 client application’s X.509 certificate. For more information, see How to generate SAML assertion for SAP SuccessFactors API. Multiple layers of protection, including AES 256 encryption, are in place to keep this value safe. When editing this connection, you must re-enter this value each time; it is stored only when the connection is saved and never displayed as text.

Generate token (required): Click this button to have integrator.io fill in an encrypted access token. Multiple layers of protection, including AES 256 encryption, are in place to keep your authentication token safe. When editing this connection, you must re-enter this value each time; it is stored only when the connection is saved and never displayed as text.

  1. Sign into your SAP SuccessFactors account, and navigate to Admin center.
  2. Under tools, search for “Manage OAuth2 client applications.”
  3. Click + Register client application and describe the new application.

  1. Generate the X.509 certificate, and download the certificate and the private key, since you have that option only now while registering the app. 
  2. Click Register to save the app.
  3. Copy the API key shown for the new app for use as your connection’s Client ID.

D. Edit advanced SAP SuccessFactors settings

Before continuing, you have the opportunity to provide additional configuration information, if needed, for the SAP SuccessFactors connection.

Borrow concurrency from (optional): Select another connection from the list....

NOTE: Selecting another app changes form...

Concurrency level (optional): Up to 25 allowed....

E. Test the connection

Once you have configured the SAP SuccessFactors connection, you have a few options for continuing:

  • Save – click this button to test the connection, commit the new connection so that it will be available to all integrations for your account
  • Save & close – click to test and save the connection and exit the Create connection pane
  • Close – click to exit without saving any new changes
  • Test connection – click this button to verify that your new connection is free of errors

When you test or save the connection, it is verified before continuing. 

The new connection is now successfully added to your account. It will be applied to the current source or destination app, if you created it within a flow. Otherwise, you may proceed to register the connection with an integration.

Related articles

Comments

0 comments

Please sign in to leave a comment.