> 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
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**: System admin role with API client registration permissions
* **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** > **OAuth2 Client Applications**
3. Click **Register Client Application**
4. Configure:
* **Application Name**: `Harmony Integration`
* **Application Type**: OAuth Server-to-Server
5. Click **Generate X.509 Certificate** (or upload your own) and note the **Client ID**
6. Download the private key as a `.pem` file - copy its full contents for use in Harmony
**Step 2: Find your API Server, Company ID, and Username**
1. **API Server hostname**: Refer to the [SAP SuccessFactors API reference](https://help.sap.com/docs/SAP_SUCCESSFACTORS_PLATFORM) to identify your regional API server (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**: Shown in parentheses next to your name in the top-right corner
**Step 3: Navigate to Integrations**
1. Log in to your Harmony dashboard
2. Go to **Settings** > **Integrations**
3. Find **SAP SuccessFactors** under **HRIS** and click **Connect**
**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, business unit, cost center)
* Organizational hierarchy (manager, reporting structure)
* Employment status (active, on leave, terminated)
* Work location and remote status
* Employment dates (hire date, termination date)
#### Use Cases
Automated Onboarding
Trigger IT provisioning the moment a new hire is added in SuccessFactors - accounts, access, and equipment ready on day one
Transfer and Promotion Workflows
Automatically adjust access and group memberships when employees change roles, departments, or locations
Seamless Offboarding
Revoke access and initiate equipment recovery as soon as a termination event is recorded in SuccessFactors
Org Chart Accuracy
Keep manager relationships and team structures current across all connected IT systems without manual updates
---
# 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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.harmony.io/integrations/hris/sap-successfactors.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.