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

# SAP SuccessFactors

> Connect SAP SuccessFactors to Doozy via Merge.

## Overview

To connect SAP SuccessFactors, you will need to provide the following information:

* **API Server URL**
* **Username**
* **Company ID**
* **Client ID** (API Key)
* **Client Secret** (from certificate)

## Prerequisites

* You have Administrator permissions in your company's SAP SuccessFactors instance

***

## Step 1: Find Your API Server URL

<Steps>
  <Step title="Navigate to the SAP SuccessFactors API Servers list.">Go to [SAP SuccessFactors API Server List](https://help.sap.com/docs/successfactors-platform/it-landscape-requirements-for-sap-successfactors/list-of-sap-successfactors-api-servers)</Step>

  <Step title="Filter for your environment (typically production)." />

  <Step title="Find your location and corresponding API Server URL.">Example: Brazil users would use `api19.sapsf.com`</Step>
</Steps>

<Tip>Your API server URL typically mirrors your SuccessFactors login URL. For example, if your login URL is `hcm68sales.successfactors.com`, your API Server URL would be `api68sales.successfactors.com`.</Tip>

## Step 2: Find Your Username and Company ID

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

  <Step title="Click your profile image in the upper right to view your username." />

  <Step title="In the same dropdown, click 'Show version information'." />

  <Step title="Find your Company ID in the modal that appears." />
</Steps>

## Step 3: Generate OAuth Credentials

<Steps>
  <Step title="In Admin Center, go to Tools and search for 'Manage OAuth2 Client Applications'." />

  <Step title="Click 'Register Client Application'." />

  <Step title="Fill out Application Name and Application URL.">The URL must begin with `https://` (the values don't matter for the integration).</Step>
  <Step title="Click 'Generate X.509 Certificate'.">Enter any Common Name and click Generate.</Step>

  <Step title="Download and save the Certificate.pem file." />

  <Step title="Click 'Register' to finish creating the application." />

  <Step title="Go back to 'Manage OAuth2 Client Applications' and click 'Edit' on your new application." />

  <Step title="Copy the API Key displayed - this is your Client ID." />

  <Step title="Open the Certificate.pem file in a text editor.">The string between `-----BEGIN ENCRYPTED PRIVATE KEY-----` and `-----END ENCRYPTED PRIVATE KEY-----` is your **Client Secret**.</Step>
</Steps>

## Enter Credentials into Doozy

<Note>You must be a **Doozy admin** to connect an HRIS integration.</Note>

<Steps>
  <Step title="Go to the Doozy web app.">Navigate to [Workspace Settings](https://doozy.live/app/settings/workspace) → **Integrations** → **HRIS**.</Step>

  <Step title="Choose SAP SuccessFactors as the HRIS you want to connect." />

  <Step title="API Server URL: Enter the URL from Step 1." />

  <Step title="Username: Enter your SAP username (not email)." />

  <Step title="Company ID: Enter your Company ID from Step 2." />

  <Step title="Client ID: Enter the API Key from Step 3." />

  <Step title="Client Secret: Enter the private key from the certificate." />

  <Step title="Click Submit." />
</Steps>