SAP Knowledge Base Article - Public

2819591 - The User Entity and the Gender field error "Mandatory" - SuccessFactors Integration Center


In this document we shall review the use of the mandatory Gender field, from the User Entity, in the context of Integration Center.
The User Entity represents a user account and contains user demographic and organizational information such as a user's department, division, location, job code, manager and other details.

In certain use-cases, you may wish to pass the value for the Gender field as NULL (i.e. not enter any value). This will result in a warning via Integration Center.

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 HXM Suite

Reproducing the Issue

1. Create an Inbound Integration using the User entity as your base-entity.

2. Do not pass any value to the Gender field e.g. "Male" or "Female".

3. You receive the following warning:

    "Mandatory value missing."


  • This is regarded as current expected system behavior.
    This field is required as per the OData API Metadata, the field Gender is set to Nullable = FALSE.
    In other words, the fields must contain a value - it cannot be NULL or BLANK.
  • Since it comes from metadata, it cannot be edited.
  • You can check Admin Center > OData API Data Dictionary:



1. Attempt to Run the Integration

    Hypothetically, this is just a Warning Message - not an error. This means it is a warning and it's not a blocker.
    You can still attempt to pass the data.
    NOTE: if it does fail, then you MUST pass a value.

2. Log an Enhancement Request

    If you wish to change the Gender Field to non-mandatory (Nullable = TRUE), please log an Enhancement Request. 
    We welcome inputs from customers to improve the functionality of our products.
    All enhancement requests are reviewed by our Product Management team and, if successful, are developed and
    implemented in a future product release.

    Details how-to here: 2281168 - How to create Enhancement Request for Successfactors Integrations

    NOTE: Cloud Product Support (CPS) is not the Portal for submitting Enhancement Request, please follow the above KBA.

See Also

2281168 - How to create Enhancement Request for Successfactors Integrations

SAP SuccessFactors HCM Suite OData API: Reference Guide


OData, Integration Center, User Entity, Gender Field, Mandatory, User: Mandatory value is missing for gender for record userId, gender. , KBA , LOD-SF-INT-INC , Integration Center , LOD-SF-INT , Integrations , Problem


SAP SuccessFactors HCM suite all versions