SAP Knowledge Base Article - Public

2814870 - Background Element field(s) not available via API / not visible in Data Dictionary


This Knowledge-Base Article has been created to address the unavailability (via API / Data Dictionary) of newly created field(s) within Background Element(s).

  1. You have added a new field to a Background Element via Manage Business Configurations
  2. When attempting to access this field via API (ODATA / SFAPI), it is not available

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


  • SuccessFactors BizX

Reproducing the Issue

To reproduce this issue, perform the below steps:

  1. Create a new field within a Background Element (e.g. Background_InsideWorkExperience)
  2. Once created, you perform use a GET API request to query / read the data in this Background Element
  3. You observe that he newly added field is not returned in the response payload from API


The field is not returned by the API, within the response payload, for the following reasons:

  • The newly created field is hidden from / not exposed to the API 


To resolve this issue, please follow the below steps:

  1. Access Manage Business Configurations  >  Employee Profile  >  Background Elements  >  Choose the affected Background Element(s)
  2. Locate the field which is having issue (i.e. not exposed to API) > Click 'Details'
  3. Ensure the 'Hidden' property is set to 'No'
    (if Hidden property is not set to 'No' the field will not be available to the API)

  4. Refresh the OData API Metadata - Metadata Refresh


After following the above outlines steps within Resolution section, the newly created field should be available within the Data Dictionary and exposed to API.

See Also

SAP SuccessFactors HCM Suite OData API: Reference Guide (Section 10.8 - Background) for additional information on Employee Profile Background Elements


Manage Business Configurations, Background Element, ODATA API, SFAPI, Hidden, Visibility , KBA , LOD-SF-INT-ODATA , OData API Framework , Problem


SAP SuccessFactors HXM Core all versions