# SAP SuccessFactors

> Source: https://truto.one/docs/integration-guides/sapsuccessfactors/

SAP SuccessFactors connects to the OData API with basic authentication: an account login name and password, your company ID and your data center's API host.

:::callout{type="info"}
- The account you connect with must have the **Allow Admin to Access OData API through Basic Authentication** permission.
:::

## Install the SAP SuccessFactors integration

Install SAP SuccessFactors from [Available integrations](https://app.truto.one/integrations/available/413cc360-ab76-4ceb-96af-0fa555f12ce4) in each environment you connect accounts from.

## Allow OData API basic authentication

1. Grant the user you connect with the **Allow Admin to Access OData API through Basic Authentication** permission.
2. In **Admin Center** → **Manage OData API Basic Authentication**, set access to **Always**. **Never** blocks the connection, and **Restrict access to below IPs** blocks it unless Truto's requests come from an address on the list.

The API host depends on your data center, for example `api4.successfactors.com`. Find it in **Admin Center** → **OData API Data Inbound Authorization**, or ask your SAP admin. Your company ID is in **Admin Center** → **Company Info**, or in the URL while you're signed in.

## Connect a SAP SuccessFactors account

1. Click **Connect Account**.
   ![Click Connect Account](https://docs-assets.truto.one/truto-connect-account.png)
2. Enter a Tenant ID. This can be any ID you choose. Click **Get connection link**.
   ![Get connection link](https://docs-assets.truto.one/truto-connect-account-modal.png)
3. Open the generated link. You can also share it with your customer so they connect their own SAP SuccessFactors account.
   ![Share connection link](https://docs-assets.truto.one/truto-connect-account-link.png)
4. Select **SAP SuccessFactors**.
5. Fill in the form and click **Connect**:

   | Field | Required | What to enter |
   |---|---|---|
   | **API Host** | Yes | Your data center's API host, for example `api4.successfactors.com`. |
   | **Company ID** | Yes | Your SAP SuccessFactors company ID. |
   | **Username (Account Login Name)** | Yes | The **account login name**, not the employment username. Find it in **Admin Center** → **Manage Users** or on the login screen. |
   | **Password** | Yes | The password for that account login name. |
6. Close the tab when you see the connection successful message. The new account appears under **Integrated Accounts**. Click its Account ID to see its details and make API calls.
