> For the complete documentation index, see [llms.txt](https://docs.harmony.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.harmony.io/integrations/hris/sap-successfactors.md).

# SAP SuccessFactors

Sync employee data and org structure from SAP SuccessFactors to keep the Harmony directory up to date automatically

The SAP SuccessFactors integration is now available in Harmony, joining the roster of supported HRIS providers. You can connect SuccessFactors directly from the Integrations settings and automatically sync employee data into Harmony - eliminating manual imports and keeping agent and user records current at all times.

#### About SAP SuccessFactors

SAP SuccessFactors is an enterprise HCM suite that manages the full employee lifecycle - from recruiting and onboarding to payroll and succession planning. Connecting SAP SuccessFactors to Harmony enables automatic syncing of employee records and organizational structure, ensuring the Harmony employee directory always reflects the current state of your workforce.

#### What the SAP SuccessFactors integration enables

| Capability              | Description                                                                  |
| ----------------------- | ---------------------------------------------------------------------------- |
| Employee Directory Sync | Keep employee profiles current with data pulled directly from SuccessFactors |
| Org Structure Sync      | Maintain accurate reporting relationships and department hierarchies         |
| Lifecycle Automation    | Trigger IT provisioning workflows on hire, transfer, and termination events  |
| Role-Based Provisioning | Automatically assign access based on job role and business unit              |

#### Prerequisites

* **SAP SuccessFactors Administrator Access**: Admin Center access to **Manage OAuth2 Client Applications**
* **API User**: The SAP SuccessFactors user the connection runs as. Every API call uses this user's permissions, so it needs OData API read access to Employee Central employee data
* **API Server Hostname**: Your regional API server (e.g. `api4.successfactors.com`)
* **Company ID**: Your SAP SuccessFactors company identifier
* **Harmony Account**: Active Harmony workspace

#### Connect SAP SuccessFactors to Harmony

**Step 1: Register an OAuth Client Application in SAP SuccessFactors**

1. Log in to SAP SuccessFactors as a system administrator
2. Go to **Admin Center** > **API Center** > **OAuth Configuration for OData** (or search for **Manage OAuth2 Client Applications** in Action Search)
3. Click **Register Client Application**
4. Configure:
   * **Application Name**: `Harmony Integration`
   * **Application URL**: Any valid URL you control (it is not used by this connection)
   * **Bind to Users**: Select it and enter the user ID of the API user
   * **X.509 Certificate**: Click **Generate X.509 Certificate** (or paste your own public certificate)
5. If you generated the certificate in SAP SuccessFactors, download the private key when prompted - you cannot retrieve it later. Keep the `.pem` file; you will paste its full contents into Harmony
6. Click **Register**, then click **View** on the new application and copy its **API Key** - this is the **Client ID**
7. Note the certificate's expiry date. When it expires, SAP SuccessFactors stops issuing tokens and the sync stops, so register a new certificate before then and update the **Client ID** and **Client Secret** in Harmony

**Step 2: Find your API Server, Company ID, and Username**

1. **API Server hostname**: Find your data center in the [List of SAP SuccessFactors API Servers](https://help.sap.com/docs/successfactors-platform/sap-successfactors-api-reference-guide-odata-v2/list-of-sap-successfactors-api-servers) and copy its API server hostname (e.g. `api4.successfactors.com`)
2. **Company ID**: Click your profile icon in the top-right corner > **Show Version Information** - the Company ID is listed there
3. **Username**: The user ID of the API user bound to the client application in Step 1, entered exactly as bound. When signed in as that user, click the profile icon in the top-right corner to see the username in parentheses. The username usually matches the user ID but not on every instance; if the connection fails, confirm the user ID in **Admin Center** > **Integration Center**

**Step 3: Navigate to Integrations**

1. Log in to your Harmony dashboard
2. Go to **Settings** > **Integrations**
3. Find **SAP SuccessFactors** under **HRIS** (or search for it by name) and click its card

**Step 4: Enter Credentials**

1. Enter your **API Server** (hostname only, e.g. `api4.successfactors.com`)
2. Enter your **Company ID**
3. Enter your **Username**
4. Enter your **Client ID**
5. Paste the full contents of your `.pem` private key into the **Client Secret** field
6. Click **Connect**

#### What Harmony Syncs

**From SAP SuccessFactors:**

* Employee profiles (name, email, employee ID)
* Job details (title, department)
* Organizational hierarchy (manager, reporting structure)
* Employment status (active, inactive, terminated)
* Work location
* Employment dates (hire date, termination date)

#### Use Cases

<details>

<summary>Automated Onboarding</summary>

Trigger IT provisioning the moment a new hire is added in SuccessFactors - accounts, access, and equipment ready on day one

</details>

<details>

<summary>Transfer and Promotion Workflows</summary>

Automatically adjust access and group memberships when employees change roles, departments, or locations

</details>

<details>

<summary>Seamless Offboarding</summary>

Revoke access and initiate equipment recovery as soon as a termination event is recorded in SuccessFactors

</details>

<details>

<summary>Org Chart Accuracy</summary>

Keep manager relationships and team structures current across all connected IT systems without manual updates

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.harmony.io/integrations/hris/sap-successfactors.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.