SAP Knowledge Base Article - Public

3157960 - Creating Interview Central Interviews via OData API - Recruiting Management

Symptom

How to create Interviews in Interview Central via OData API?

Environment

SAP SuccessFactors Recruiting Management

Resolution

API WARNING: API upsert is a powerful tool to help you automate manual tasks and edit data that is not possible or difficult to do in the UI. However, this can also lead to unintentional data changes if mishandled. Make sure you understand how to use the ODATA API Data Dictionary and the integration tools in general. If possible, test first with your preview environment and with only a subset of your data to see whether you are getting the intended results. 

Moreover, creating scripts and making recommendations on how to make them are outside support scope and are typically requests handled by partners. If you have issues that are possible defects, please feel free to reach out to Support.

Important notes:

  • With Interview Scheduling tool enabled, you can't schedule interviews using the OData APIs.
  • The JobApplicationInterview entity supports field level and row level permissions. If you aren't a part of the interview process, you can't view any information about the candidate. By default, only the assigned interviewers of a job application can read or edit the permissioned fields in JobApplicationInterview entity.

The following role-based permissions allow admin users to read or edit all fields in JobApplicationInterview entity:

  • Manage Permission Roles  Recruiting Permissions  OData API Application Export
  • Manage Permission Roles  Recruiting Permissions  OData API Application Export
  • Manage Permission Roles  Recruiting Permissions  OData API Application Update
  • Manage Permission Roles  Recruiting Permissions  OData API Interview Central Create/Update

Supported Operations: Query, Insert, Upsert, and Delete.

With that in mind, please refer to a sample:

{
                "__metadata": {
                    "uri": "https://apisalesdemo4.successfactors.com/odata/v2/JobApplicationInterview",
                    "type": "SFOData.JobApplicationInterview"
                },

               "startDate": "/Date(1646676000000+0000)/",
               "templateType": "JOB_REQ",       
               "source": "INTERNAL",        
               "applicationId": "123",
               "notes": null,               
               "interviewer": {

                    "__metadata": {
                        "type": "SFOData.User"
                    },
                    "userId": "user123"

               }

For more information, please refer to the OData Admin Guide: JobApplicationInterview

See Also

3118248 - How to remove Interviewers via OData API in Interview Central - Recruiting Management

3116372 - How to update the Interview Start Date via OData API - Recruiting Management

Keywords

KBA , LOD-SF-RCM , Recruiting Management , How To

Product

SAP SuccessFactors Recruiting all versions