Purpose
This guide explains which SAP SuccessFactors permissions a service user needs to connect to BetterUp®, and how to set them up.
Overview
If you connect SAP SuccessFactors with a dedicated service user, that user needs two things: a permission group and a read-only permission role. You set both up in SAP SuccessFactors, then return to SAP SuccessFactors: Connect your account to finish the connection.
BetterUp doesn't use pay, payroll, or bank data, so you can leave those permissions off.
Jump to: Roles and responsibilities | Configuration and setup | Permissions reference | FAQs
Roles and responsibilities
| Role | Responsibilities |
|---|---|
| SAP SuccessFactors admin | Create the permission group and role, grant the permissions below, and assign the role to the service user. |
Before you start, make sure:
- You're an administrator in your company's SAP SuccessFactors instance.
- You've created the service user (Step 1 of SAP SuccessFactors: Connect your account).
Configuration and setup
Step 1: Create a permission group
- Search for Manage Permission Groups to open the Permission Groups page.
- Select Create New. Give the group a name that shows it's for the BetterUp connection.
- Set User Type to Employee, and add the service user under Choose Group Members. Leave Exclude and Granted Permission Roles empty.
- Select Done to save the group.
Step 2: Create a permission role
- Search for Manage Permission Roles to open the Permission Role page.
- Select Create.
- Give the role a name that shows it's for the BetterUp connection, then select Next.
- Grant the permissions in the Permissions reference below, then continue to Step 3.
Step 3: Save and assign the role
- After setting permissions, select Next at the bottom right.
- Review the permissions, then select Save.
- When asked whether to assign the role, select Yes.
- On the Basic Information tab, leave Name as is, set Target Population User Type to Employee and Status to Active, then select Next.
- On the Grant Access To tab, select the permission group from Step 1, then select Next.
- On the Define a Target Population tab, select Everyone, then select Next.
- Select Next to go to Define Data Blocking. You may not see this step, depending on the permissions you chose.
- Leave the default data blocking and select Next to see the preview.
- Review your setup, then select Save.
Next, return to SAP SuccessFactors: Connect your account and continue with Step 3.
Permissions reference
Grant the permissions in each table below. Every permission is view-only except the integration tools needed to generate credentials.
Required for every connection
| Permission | Access | Why it's needed |
|---|---|---|
| Manage Integration Tools > Manage OAuth2 Client Applications | Yes | To generate OAuth credentials (Step 5 of Connect your account) |
| Manage Integration Tools > Manage OData API Basic Authentication, plus related API and OData permissions | Yes | API access |
| General User Permission > User Login | Yes | Lets the user sign in to generate credentials |
| General User Permission > User Search | Yes | Access to the User entity |
| Employee Central API > Employee Central Foundation | Yes (read-only) | Access to company data |
| Employee Central API > Employee Central Import Settings | Yes | Access to employee data |
| Manage System Properties > Picklist Management and Picklists Mappings Set Up | Yes | Labels for fields like employment status |
Employee Central Effective Dated Entities > Personal Information
Needed for names and demographic data. Select View Current at the top of the grid to select them all.
| Permission | Access | Notes |
|---|---|---|
| Personal Information Actions | View Current | Access to the PerPersonal entity |
| First Name, Middle Name, Last Name, Preferred Name | View Current | |
| Gender, Marital Status, Nationality | View Current | |
| Any custom or other fields you want to share | View Current |
Employee Central Effective Dated Entities > Addresses
| Permission | Access | Notes |
|---|---|---|
| Address Information Actions | View Current | Needed for employee address data |
Employee Central Effective Dated Entities > Job Information
Needed for job and position data. Select View History at the top of the grid to select them all.
| Permission | Access | Notes |
|---|---|---|
| Job Information Actions | View History | Access to the EmpJob entity |
| Position, Position Entry Date | View History | |
| Company, Business Unit, Division, Department, Location, Cost Center | View History | |
| Supervisor | View History | |
| Job Classification, Job Title | View History | |
| Regular/Temporary, FTE, Employee Type, Employee Class, Employment Type | View History | |
| jobInfo_seq-number, jobInfo_event-reason | View History | |
| Any custom or other fields you want to share | View History |
Employee Data > HR Information
Select View Current at the top of the grid to select them all.
| Permission | Access | Notes |
|---|---|---|
| Biographical Information | View | Required for all connections. Access to the PerPerson entity. |
| Phone Information | View | Needed for phone data |
| Email Information, Business Email Address | View | Needed for email data |
| Business Address | [ACCESS NEEDED] | |
| Any custom or other fields you want to share | View |
Employee Data > Employment Details
Select View Current at the top of the grid to select them all.
| Permission | Access | Notes |
|---|---|---|
| Employment Details MSS | View | Required for all connections. Access to the EmpEmployment entity. |
| Hire Date | View | Required for all connections |
| Termination Date | View | Required for all connections |
| Original Start Date | View | |
| Any custom or other fields you want to share | View |
Not needed
BetterUp doesn't use pay, payroll, or bank data. You can leave these off:
- Employee Central Effective Dated Entities > Compensation Information
- Payroll Integration Permissions
- Miscellaneous Permissions > Payment Information
FAQs
Why does BetterUp need read-only access?
BetterUp only reads employee data to create and update member accounts. It doesn't write anything back to SAP SuccessFactors.
Do I need to grant every permission listed?
Grant everything under Required for every connection, Biographical Information, and Employment Details. Grant the rest based on the data you want to share.
I don't see the Define Data Blocking step. Is that a problem?
No. It only appears for some permission combinations.
Still stuck? Contact tech-ipm@betterup.co or your BetterUp implementation contact.
Jump to: Roles and responsibilities | Configuration and setup | Permissions reference | FAQs