SAP Knowledge Base Article - Public

3216169 - Unable to Initiate Onboarding via Odata API - Onboarding


  • Issue with creating a new Onboardee through integration with ATS
  • Not able to initiate onboarding via API
  • Unable to Initiate Onboarding via Odata API
  • Values missing for mandatory keys:

Image/data in this KBA is from SAP internal systems, sample data, or demo systems. Any resemblance to real data is purely coincidental. 



SAP SuccessFactors Onboarding

Reproducing the Issue

  1. We are trying to initiate onboarding for user * API and getting the below error :
  2. Values missing for mandatory keys:


OnboardingBpeAdmin missing permission for Legal Entitity.


  1. Navigate to Manage Permission Roles.
  2. Search for OnboardingBpeAdmin.
  3. Click on the role.
  4. Click on Permissions button.
  5. Navigate to MDF Foundation Objects.
  6. Provide View Current, View History, Create,  Insert, Correct , Delete, Import/ExportPermission for Legal Entity.

  7. Under Manage Onboarding or Offboarding >  Initiate Onboarding API Permission
  8. Also ensure the API user has the above two permissions
  9. Save, and perform an OData API Metadata Refresh And Export.
  10. Try to initiate Onboarding again.

See Also

SAP SuccessFactors HXM Suite OData API: Reference Guide (V2)


Values missing for mandatory keys:, API, ATS, Initiate Onboarding, Failed, Country, Company, Legal Entity , KBA , LOD-SF-OBX-ODM , Data Model , Problem


SAP SuccessFactors Onboarding