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

# SAP SuccessFactors

<figure><img src="/files/6PfJV31e3UwAAnddd6uq" alt=""><figcaption></figcaption></figure>

### What you get

* **Live People directory** — SuccessFactors workers appear in Siit with their full role and org context.
* **Lifecycle triggers** — Hire date, Termination date, and Birthday flow into Siit as workflow triggers.
* **Organization awareness** — department, cost center, location, and legal entity hierarchies are preserved for routing, approvals, and audiences.
* **Manager resolution** — SuccessFactors' reporting structure powers auto‑selected approvers.
* **Multi‑entity support** — legal entity, company, and region are synced and usable as workflow conditions.

### What syncs from SuccessFactors

| Category        | Fields                                                     |
| --------------- | ---------------------------------------------------------- |
| Identity        | Preferred name, legal name, work email, person ID, user ID |
| Role            | Job title, job code, department, division                  |
| Org structure   | Manager, cost center, location, company, legal entity      |
| Employment      | Worker type, employment status                             |
| Lifecycle dates | Hire date, termination date, date of birth                 |

Work email is the canonical identifier.

### Before you connect

SuccessFactors requires more preparation than most HRIS platforms. Setup varies significantly by tenant configuration. You'll need:

* A SuccessFactors admin to configure an OData API user and the relevant role-based permissions.
* Your tenant URL and API endpoint.
* Agreement with your SuccessFactors administrator on the scope of data exposed to Siit.

For the recommended setup for your tenant, reach out to support via the in‑app chat — we'll work with you to scope and configure the connection correctly.

### Connect SAP SuccessFactors

1. Have your SuccessFactors admin create an OData API user with the required permissions to read worker data.
2. In Siit, go to **Settings → Integrations**, find **SAP SuccessFactors** in the HRIS section, and click **Connect**.
3. Enter your tenant URL, API user credentials, and any company-specific identifiers.
4. Review the imported workers and field mapping, then click **Finish setup**.

### After the connection

* Compare Siit's worker count with your SuccessFactors active worker report.
* In **Settings → People → Fields**, set SuccessFactors as the source of truth for org‑structure fields if you're also connected to an IdP.
* Build a Day‑1 onboarding workflow using the Hire date trigger.

### Sync frequency

SuccessFactors data refreshes every few hours by default. For very large tenants, the schedule is tuned based on worker count. Manual syncs are available from **Settings → Integrations → SAP SuccessFactors → Sync now**.

### Common workflows

**Day‑1 onboarding.** *Trigger: Hire date. Actions: create IdP account, assign apps by department, ship equipment, DM manager.*

**Offboarding on termination.** *Trigger: Termination date. Actions: revoke sessions, remove app access, equipment pickup, notify manager.*

**Legal entity‑aware approval.** *Condition: Requester's legal entity → Route to the right regional approver.*

### Troubleshooting

**"401 Unauthorized" on connect.** The API user password is wrong, expired, or the user has been locked. Reset and update Siit.

**Workers missing.** The API user's role-based permissions likely lack access to a specific employee group or business unit. Ask your SuccessFactors admin to extend the permission scope.

**Sync is slow on a large tenant.** Reach out via in‑app chat — we can adjust the sync strategy for your tenant.

**Custom field missing.** Make sure the field is included in the API user's role permissions, then re-map in Siit.