2942697 - Error Unable to insert data due to a server error. Please try again. When initiating Onboarding manually through Add New Hire to Onboarding page

Error in Add New Hire to Onboarding page. "Unable to insert data due to a server error."

SAP SuccessFactors Onboarding

1. Go to Admin center.
2. Search Add new hire to Onboarding.
3. Input all the required candidate details.
4. Click on 'Initiate Onboarding'.
5. The error appears.

There are several possible causes for this error and below are some of them:

Cause 1:

Hide Username in the UI is enabled.

Cause 2: 

Email Type "P" is currently not configured in ecEmailType in Picklist Center.
Error found in the backend logs: Email type P is not in picklist ecEmailType.

Cause 3:

No Permissions for 'Employee Central Foundation API' access permission for FOEventReason.

Cause 4: 

error" : {
"code" : "COE_GENERAL_FORBIDDEN", "message" : {
"lang" : "en-US", "value" : "[COE0020]Onboarding 2.0 initiate permission is required"
}

Cause 5:

The field 'email-type' has an incorrect picklist name in Manage Business Configuration.
Replicate the issue and check the browser's dev tool (Fn+F12).
Error found in console: [COE0019]Save EC data failed. The error message is: Business key - email-type - has invalid value: Pfor entity emailInfo for userSysId:XXBusiness key - email-type - has invalid value: Pfor entity emailInfo for userSysId:XX with the index 0"

Cause 6:

Cause seen in the back-end logs: [Error Code: 3]The provided username is already in use. Choose a different user name.

Solution 1:

Hide Username in the UI  enabled.
In the instance -> Platform Feature settings -> Hide Username in the UI is enabled
If so, please uncheck it and save the changes.
Post making the changes re-test it.

Solution 2:

Check in Picklist Center> ecEmailType if Email type P has correct value for Non-unique External Code  field. It should be "P". In case you have "1", then change it to "P", save the changes and re-test
For Product Support: search in the backend logs and look for similar error to confirm: Email type P is not in picklist ecEmailType.

Solution 3:

Grant permission for 'Employee Central Foundation API' access permission for FOEventReason.

Solution 4:

Grant permission below to responsible users

Manage Onboarding or Offboarding

• Initiate Onboarding API Permission

Solution 5:

Change the picklist type used for the field 'email-type' in Manage Business Configuration UI.

Solution 6:

There are different work arounds:

1. Use a different email address
2. Proceed with the original user created
3. Purge the original user created

Unable to insert data due to a server error, Onboarding 2.0, ONB, OBX, add new hire to onboarding, [Error Code: 3], The provided username is already in use , KBA , LOD-SF-OBX-MAN , Manual Onboarding , Problem