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 10), 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 15.1.4, "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.

NOTE2: In case you need to rehire a contingent worker as a full time employee, use the steps below:

  • 1) Create employment info (OData API upsert in the EmpEmployment) with the same person ID but with a different user ID. Please notice that you will not need any OData API upsert in the OData.User entity (this is created automatically after your OData API upsert in the EmpEmployment.
  • 2) Create job information (OData API upsert in the EmpJob).
  • 3) Create or update any other entities as necessary

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