> ## Documentation Index
> Fetch the complete documentation index at: https://hub.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SAP SuccessFactors

> Follow these steps to connect SAP SuccessFactors with StackOne Hub successfully.

<Warning>
  Ensure you have Admin privileges for your SAP SuccessFactors account with permission for the Manage Integration Tools > Manage OAuth2 Client Applications.
</Warning>

If you've been directed to StackOne to integrate with SAP SuccessFactors, the following steps will help you understand the process and any necessary actions to configure successful integration.

## Locating API Server

<Steps>
  <Step title="Find the API Server">
    SAP uses multiple API server addresses. You will need to look up the API server that corresponds to your tenant domain on this [table](https://help.sap.com/docs/SAP_SUCCESSFACTORS_PLATFORM/d599f15995d348a1b45ba5603e2aba9b/af2b8d5437494b12be88fe374eba75b6.html) under the `API Server` column.

    For example, if your domain was `https://pmsalesdemo8.successfactors.com/` you would search for `salesdemo8` in the table.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="API Server Example" src="https://mintcdn.com/stackone-hub/DSTDvdfXE5cXWfs9/images/sapsuccessfactors/image1.png?fit=max&auto=format&n=DSTDvdfXE5cXWfs9&q=85&s=ee42d3ca339fcf097f13460a3d106942" width="1202" height="589" data-path="images/sapsuccessfactors/image1.png" />
    </Frame>

    Copy the value in the `API Server` column (remove the final forward-slash `/`). In this example, the value would be `https://apisalesdemo8.successfactors.com`.

    Use this value as the `API Server` value when connecting SAP SuccessFactors to StackOne.
  </Step>
</Steps>

## Finding Username

<Steps>
  <Step title="Login to SAP SuccessFactors">
    Login to SAP SuccessFactors.
  </Step>

  <Step title="Locate Your Username">
    Select your profile image in the upper right-hand corner of the screen.

    Your username is the value in parenthesis. Copy this value and note it as your `Username`.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Username Location" src="https://mintcdn.com/stackone-hub/DSTDvdfXE5cXWfs9/images/sapsuccessfactors/image2.png?fit=max&auto=format&n=DSTDvdfXE5cXWfs9&q=85&s=1b2098a0923d08e7f11ec8ecf4b8f1ca" width="777" height="283" data-path="images/sapsuccessfactors/image2.png" />
    </Frame>
  </Step>
</Steps>

## Finding Company ID

<Steps>
  <Step title="Show Version Information">
    Within the same dropdown from Step 2, select the Show version information option.
  </Step>

  <Step title="Locate Company ID">
    Within the modal that appears, you will see `Company ID`. Copy and note down this value.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Company ID" src="https://mintcdn.com/stackone-hub/DSTDvdfXE5cXWfs9/images/sapsuccessfactors/image3.png?fit=max&auto=format&n=DSTDvdfXE5cXWfs9&q=85&s=a029fa2cdb119f86bf6e3005d5b51def" width="551" height="443" data-path="images/sapsuccessfactors/image3.png" />
    </Frame>
  </Step>
</Steps>

## Registering a new Client Application

<Steps>
  <Step title="Search for Manage OAuth2 Client Applications">
    In the upper right search bar, search for Manage OAuth2 Client Applications and select the option under Actions.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Manage OAuth2 Client Applications" src="https://mintcdn.com/stackone-hub/DSTDvdfXE5cXWfs9/images/sapsuccessfactors/image4.png?fit=max&auto=format&n=DSTDvdfXE5cXWfs9&q=85&s=2a273103ed255d67af4480e784f1e3f6" width="1066" height="296" data-path="images/sapsuccessfactors/image4.png" />
    </Frame>
  </Step>

  <Step title="Register Client Application">
    Select Register Client Application.
  </Step>

  <Step title="Enter Application Details">
    Enter an Application Name, e.g. `StackOne`.

    Enter an Application URL. Note: This can be any URL and is not used in this integration.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Register Client Application" src="https://mintcdn.com/stackone-hub/DSTDvdfXE5cXWfs9/images/sapsuccessfactors/image5.png?fit=max&auto=format&n=DSTDvdfXE5cXWfs9&q=85&s=5e47fac7b761a4e30362e84b45817b7b" width="1006" height="693" data-path="images/sapsuccessfactors/image5.png" />
    </Frame>
  </Step>
</Steps>

## Generating X.509 Certificate

<Steps>
  <Step title="Generate X.509 Certificate">
    Press the Generate X.509 Certificate button.

    Enter any Common Name(CN) for the certificate, e.g. `StackOne OAuth2`.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Generate X.509 Certificate" src="https://mintcdn.com/stackone-hub/DSTDvdfXE5cXWfs9/images/sapsuccessfactors/image6.png?fit=max&auto=format&n=DSTDvdfXE5cXWfs9&q=85&s=bc28705fb3c22947af4d404d07004d12" width="1013" height="489" data-path="images/sapsuccessfactors/image6.png" />
    </Frame>
  </Step>

  <Step title="Copy the Certificate">
    Press Generate.

    Copy the value inside the X.509 Certificate section.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Copy X.509 Certificate" src="https://mintcdn.com/stackone-hub/DSTDvdfXE5cXWfs9/images/sapsuccessfactors/image7.png?fit=max&auto=format&n=DSTDvdfXE5cXWfs9&q=85&s=aca3a384a2815813be2b039567533306" width="1290" height="730" data-path="images/sapsuccessfactors/image7.png" />
    </Frame>
  </Step>
</Steps>

## Downloading Private Key

<Steps>
  <Step title="Download Private Key">
    Press the Download button.

    ❗Caution: The downloaded file contains your private key. This should be handled securely, and this local file should be deleted after your StackOne account has been linked.
  </Step>

  <Step title="Copy the Private Key">
    Select and copy the long string of characters between -----BEGIN ENCRYPTED PRIVATE KEY----- and -----END ENCRYPTED PRIVATE KEY-----

    This value is your Private Key. Please keep it safe!
  </Step>
</Steps>

## Finding API Key

<Steps>
  <Step title="Locate API Key">
    Your API Key is displayed on the Manage OAuth2 Client Applications screen above your X.509 Certificate.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="API Key" src="https://mintcdn.com/stackone-hub/DSTDvdfXE5cXWfs9/images/sapsuccessfactors/image8.png?fit=max&auto=format&n=DSTDvdfXE5cXWfs9&q=85&s=6bb64adf25cd2aa893da6024cbc7229d" width="1290" height="732" data-path="images/sapsuccessfactors/image8.png" />
    </Frame>
  </Step>
</Steps>

## Connecting with StackOne

<Steps>
  <Step title="Enter the Details">
    Upon reaching the Link Account page, enter the gathered details and proceed by clicking the `Connect` button.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Link Account" src="https://mintcdn.com/stackone-hub/DSTDvdfXE5cXWfs9/images/sapsuccessfactors/image9.png?fit=max&auto=format&n=DSTDvdfXE5cXWfs9&q=85&s=39675abccb85d6f8b8f9f86bdcc910d1" width="952" height="1472" data-path="images/sapsuccessfactors/image9.png" />
    </Frame>
  </Step>
</Steps>

<Note>
  Note: The integration may take up to 15 minutes to initially authenticate once the account has been connected. In the meantime, requests will return a 401: Unauthorized response.
</Note>

## Useful Links

<Card title="API Reference" icon="link" href="https://api.sap.com/products/SAPSuccessFactors/apis/all">
  [https://api.sap.com/products/SAPSuccessFactors/apis/all](https://api.sap.com/products/SAPSuccessFactors/apis/all)
</Card>