Symptom
- A permission error occurred when trying to add an Employee Referral Program candidate using OData API: "[COE0019]Please grant the following permissions: Employee Referral - pool or Employee Referral - job specific".
- The error persists even after granting the permission to the API user.
Environment
SAP SuccessFactors Recruiting Management
Reproducing the Issue
- Add an Employee Referral Program candidate using the CandidateEmployeeReferral entity in OData API.
- An error occurred: "[COE0019]Please grant the following permissions: Employee Referral - pool or Employee Referral - job specific".
Cause
The system checks if the employee who referred the candidate ("referredBy") has the necessary permissions. This is determined by whether the feature 'Check for employee referral permissions for adding candidate (pool and job specific)' has been enabled in Admin Center > Set Up Employee Referral Program.
Here are some possible causes:
- The employee does not have the employee referral permissions.
- A wrong User Sys ID is provided for the "referredBy" field in the API request.
Resolution
Grant the following permissions to the employee in the "referredBy" field.
- Recruiting Permissions > Employee referral - pool
- Recruiting Permissions > Employee referral - job specific
Make sure to provide the correct User Sys ID for the "referredBy" field. Please note that only the User Sys ID is accepted, and not the username.
See Also
- KBA 3539412 - Unknown property referralResume for CandidateEmployeeReferral - Recruiting Management
- KBA 3328418 - How to Add a Candidate Employee Referral via ODATA API (Single and Batch Request) - Recruiting Management
- SAP SuccessFactors API Reference Guide (OData V2): CandidateEmployeeReferral
Keywords
RCM, OData, API, Employee Referral, Candidate, Permission, Error, pool, job specific, CandidateEmployeeReferral , KBA , LOD-SF-RCM-API , Webservices & APIs , LOD-SF-RCM-INT , Integration Center & Intelligent Services , LOD-SF-RCM-CAN , General Candidate Issues (not Offers, not Profiles) , Problem