Have the client verify that the user the API Key was generated under has org admin permissions (with cog access enabled) and that the user is active in the PI Software. If the user has been disabled, a new API Key will need to be generated under a different user
Possible reasons for a candidate not receiving an assessment include:
Verify that the notifyAssessmentTakerUsingEmail
property is set to true.
Verify that the candidate does not already exist with a completed assessment. See the section below this on scenarios where an assessment will not be sent for existing candidates.
The candidates-v1 POST endpoint returns a property of isExistingCandidate
that will indicate whether or not a new candidate record was created as part of the assessment sending operation.
The creation or reuse of a candidate will behave as follows in these common scenarios:
If there is no candidate found:
IsExistingCandidate = false,
New Behavioral Assessment sent (if requested),
New Cognitive Assessment sent (if requested)
If there is a candidate found with completed Behavioral Assessment + Cognitive Assessment :
IsExistingCandidate = true
No assessments sent
Behavioral Assessment and New Cognitive Assessment results returned in the response
If there is a candidate found with a completed Behavioral Assessment + no or pending Cognitive Assessment:
IsExistingCandidate = true,
No Behavioral Assessment sent
Cognitive Assessment will be sent or resent
Completed Behavioral Assessment results and pending Cognitive Assessment results included in the response
If there is a candidate found with a completed Cognitive Assessment + no or pending Behavioral Assessment:
IsExistingCandidate = true
No Cognitive Assessment sent
Behavioral Assessment will be sent or resent
Completed Cognitive Assessment results and pending Behavioral Assessment results included in the response
If a there is a candidate found with no completed results:
IsExistingCandidate = true
Behavioral Assessment (if requested) and Cognitive Assessment (if requested) will be sent
Pending Behavioral Assessment and Cognitive Assessment results included in the response
If there is a candidate found and their details differ from the request body the following would be updated if different:
firstName
lastName
middleName
gender
isBookmarked
email - Only if found by an externalPersonId match
externalPersonId - Only if found by an email match
jobId - Note this would update the Behavioral Job Fit and Cognitive Job Fit Scores. The Candidate would then appears under the new job association within the PI software.