SAP Knowledge Base Article - Public

3714179 - getUserNameOfNewlyHiredEmployee API returning 404 error

Symptom

  • The getUserNameOfNewlyHiredEmployee API call fails with a 404 error.
  • Error message: "The resource requested was not found."
  • Error code: "NotFound".

Environment

SAP SuccessFactors Onboarding

Reproducing the Issue

  1. Attempt to update the username for future hire records using the updateUserNamePostHiring API from CPI.
  2. Use the getUserNameOfNewlyHiredEmployee API to fetch the username of newly hired employees.
  3. Ensure the candidate has successfully completed the Manage Pending Hires step and has a future joining date.
  4. Execute the API call.
  5. Observe the 404 error returned by the API.

Cause

  • The API call fails because the URL used does not include the required version parameter (`v1`), causing it to be unrecognized in the system logs.

Resolution

  • Use the correct API URL with the mandatory version parameter:
    https:/api-server/odatav4/onboarding/AdditionalServices.svc/v1/getUserNameOfNewlyHiredEmployee(userId='2011024364')
  • Ensure the version (`v1`) is included in the API URL to avoid recognition issues.
  • Ensure you have the Manage Onboarding or Offboarding >> Initiate Onboarding API Permission.

See Also

  • a href="https://help.sap.com/docs/successfactors-platform/sap-successfactors-api-reference-guide-odata-v4/fetching-username-of-new-hire" Fetching Username of New Hire API Reference Guide /a

Keywords

getUserNameOfNewlyHiredEmployee, 404 error, API version, v1, onboarding, ATS integration, Manage Pending Hires, updateUserNamePostHiring, username fetch, SAP SF onboarding, API failure, error code, resource not found. , KBA , LOD-SF-OBX-ATS , ATS Integration , Problem

Product

SAP SuccessFactors Onboarding 2511