> ## Documentation Index
> Fetch the complete documentation index at: https://stackone-hub-docs-confluence-api-token-update.mintlify.site/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-docs-confluence-api-token-update/lxJo9u7ebkkFpY1x/images/sapsuccessfactors/image1.png?fit=max&auto=format&n=lxJo9u7ebkkFpY1x&q=85&s=6072931ec422de7e0c431592e444283a" 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-docs-confluence-api-token-update/lxJo9u7ebkkFpY1x/images/sapsuccessfactors/image2.png?fit=max&auto=format&n=lxJo9u7ebkkFpY1x&q=85&s=26a7a23e34e66aebf44f5717fab2f230" 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-docs-confluence-api-token-update/lxJo9u7ebkkFpY1x/images/sapsuccessfactors/image3.png?fit=max&auto=format&n=lxJo9u7ebkkFpY1x&q=85&s=c152f979e0d655ee9f141b64056fd8e7" 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-docs-confluence-api-token-update/lxJo9u7ebkkFpY1x/images/sapsuccessfactors/image4.png?fit=max&auto=format&n=lxJo9u7ebkkFpY1x&q=85&s=97a501eb0180f4e714cb717c48cf32ce" 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-docs-confluence-api-token-update/lxJo9u7ebkkFpY1x/images/sapsuccessfactors/image5.png?fit=max&auto=format&n=lxJo9u7ebkkFpY1x&q=85&s=e2a2f7b3e9e4de714c25600215d1bc01" 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-docs-confluence-api-token-update/lxJo9u7ebkkFpY1x/images/sapsuccessfactors/image6.png?fit=max&auto=format&n=lxJo9u7ebkkFpY1x&q=85&s=783afff1474360c0927751ec64ed0fb9" 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-docs-confluence-api-token-update/lxJo9u7ebkkFpY1x/images/sapsuccessfactors/image7.png?fit=max&auto=format&n=lxJo9u7ebkkFpY1x&q=85&s=5b7ed7ea9fd686ce04c8dc477d1ba4f1" 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-docs-confluence-api-token-update/lxJo9u7ebkkFpY1x/images/sapsuccessfactors/image8.png?fit=max&auto=format&n=lxJo9u7ebkkFpY1x&q=85&s=eb576ef6fb4a41892f07ff330809c2c7" 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-docs-confluence-api-token-update/lxJo9u7ebkkFpY1x/images/sapsuccessfactors/image9.png?fit=max&auto=format&n=lxJo9u7ebkkFpY1x&q=85&s=3f360097d90f6b012d3d40619b6d8988" 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>

<br />

Congratulations, you're all set! If you face any issues with the steps mentioned above,
please contact us by emailing [integrations@stackone.com](mailto:integrations@stackone.com). We're always here to assist you!

## 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>