SAP Knowledge Base Article - Public

2569249 - How to insert a candidate without providing all the required basic fields Odata - RCM


When inserting a candidate in RCM module using the candidate entity in Odata, you must provide all the basic fields, firstName, lastName, primaryEmail, cellPhone and country. These 5 fields are mandatory for any insert. Even if they are not marked as required in the Candidate Profile template neither in Odata Dictionary, you have to inform these 5 fields, otherwise, you will get an error and the insert call will fail.


SAP SuccessFactors Recruiting Management


Recruiting Management module has launched a new OData entity named CandidateLight.

The CandidateLight entity allows a user to query, insert and update the candidate profile. It contains all core candidate profile data consisting of system, standard and custom fields. The metadata will show the standard and custom fields configured in the active template. If a field (standard or custom) is not configured in the template, then it will not show up in the metadata and not be a part of oData query. The system fields will always show up.

Compared to the existing candidate entity it provides exactly the same functionality but the validation of mandatory fields is different, fewer mandatory fields are available. With this new entity, it is possible to insert candidate data without providing all the 5 basic fields.


candidate, entity, CandidateLight, upsert, insert, Odata, API , KBA , LOD-SF-RCM , Recruiting Management , Problem


SAP SuccessFactors Recruiting all versions