SAP Knowledge Base Article - Public

2869117 - How to manage (create, update, rehire) Contingent Workers on EC via OData API - SuccessFactors


What is the process of creating, updating or rehiring contingent workers on EC via OData API requests?


  • SAP SuccessFactors HXM Suite
    • OData API


First thing to do would be checking if all the requirements for Contingent Workers were properly set up in your instance. They are explained in the topic 3, "Setting Up Contingent Workers" (page 11), of the guide below:

Contingent Workforce Management

After this, in this same guide, you'll find an explanation on how to manage Contingent Workers via API in the topic 13.1.3, "Managing Contingent Workers with an API", on page 66.

NOTE: In case you need to rehire a full time employee as a contingent worker, use the "Rehire a contingent worker (new employment switch is On)" method described on page 67. The userId chosen for the new EmpEmployment entity should be one that doesn't exist in the system yet.

See Also

SAP SuccessFactors Employee Central OData API: Reference Guide

SAP SuccessFactors HXM Suite OData API: Developer Guide


odata, api, sfapi, successfactors, success factors, sf, sfsf, bizx, contingent worker, cw, external employee, isContingentWorker, employee central, hire, work order, upsert, workorder , KBA , LOD-SF-INT-EC , Employee Central SFAPI & OData Entities , LOD-SF-INT , Integrations , LOD-SF-INT-ODATA , OData API Framework , How To


SAP SuccessFactors HXM Suite all versions